Unlike tools which perform individual actions, skills coordinate reasoning to accomplish multi-step work. 

For example, a FinancialsAgent might be equipped with an invoice management skill. If you ask Ed, "Create John Smith a $250.00 invoice for automobile parts and then show me all of his unpaid invoices," the FinancialsAgent invokes its invoice management skill. The skill instructs the agent to create an invoice with the relevant inputs, then retrieve and display John Smith's open invoices. Then, it specifies that the results should always be returned as a table with columns for Invoice Number, Customer, Amount, and Status.

Without the skill, the agent could still execute individual tools to create or retrieve invoices, but the format and structure of the response would vary depending on how the agent interprets the request. The skill guides the agent to handle these requests consistently and returns results in a predictable format, regardless of any underlying changes to the AI model.

Create skills with the Agent Skill Definitions application. Learn more in Agent Skill Builder application.

Agent Skill Builder application

Use the Agent Skill Builder to create skills that are embedded in an agent's system prompt at runtime. Skills define how an agent thinks and behaves when handling a request. 

Use skills when a task requires multiple steps, reasoning, or coordination between tools.

General Configuration page

Select the product family and product module for your skill. These must be the same as the agent using the skill. 

Instructions page

Write detailed instructions that define this skill's behavior. Include the purpose, trigger conditions, expected inputs and outputs, and examples. Markdown is supported but not required. 

Attachments

You can attach files, such as reference documents or spreadsheets, directly to a skill. The agent's file-reading tools automatically read these attachments, so a skill's instructions can reference them.

To attach a file, select the Attachments form action or drag it onto the skill in the Agent Builder canvas. Attached files are included when the skill is promoted to another environment or exported.

Example instructions

Invoice Management Skill Instructions:

Purpose: You are responsible for handling customer invoice requests, including creating new invoices and retrieving existing ones. Use this skill when a user asks to create, view, or inquire about customer invoices.

Trigger conditions: Use this skill when the user's request involves creating a new customer invoice, retrieving or displaying existing invoices, requests that involve both creating and retrieving invoices in a single interaction.

Expected inputs:

  • Customer name
  • Invoice amount
  • Memo or description
  • Any filters for retrieval (such as customer name, status, or date range)

Steps:

  1. If the request involves creating an invoice, execute the Create Invoice tool first before retrieving records.
  2. If the request involves retrieving invoices, apply any filters specified by the user.
  3. Always confirm with the user before creating a record if any required inputs are missing or unclear.

Response format: Always return invoice results as a table with the following columns: Invoice Number, Customer, Amount, Due Date, Status. Do not return results as a list or paragraph.

Constraints:

  • Do not create invoices without a customer name, amount, and memo.
  • Do not delete or modify existing invoices unless explicitly instructed.