---
schema_version: "1"
id: 8ad373bb57f635009f3fe164866dc230b3e9b9e82443e7a6816aa5e82f2e88bb
title: Get to Know Skills and Skill Builder
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/skill_builder_get_to_know.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.skill_builder_get_to_know.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 883f6095e9176f58c961c9f4ab87b2e504fc1d415e0af1030768ce5d18a9eaf7
description: Learn what a skill is, how Skill Builder is organized, and when to use a skill.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Get to Know Skills and Skill Builder

Learn what a skill is, how Skill Builder is organized, and when to use a skill.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, and <strong>Unlimited</strong> Editions with the Einstein for Sales add-on.</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
      <colgroup>
        <col style="width:50%">
        <col style="width:50%">
      </colgroup>
      <thead class="slds-text-title_caps ">
        <tr class="">
          <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d112321e67">User Permissions Needed</th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d112321e67 ">To create, edit, run, and share your own skills in Skill Builder:</td>

          <td class="slds-cell-wrap" style="vertical-align:top;" headers="d112321e67 ">
            <p>AI Skill User permission set</p>
            <ul>
              <li>Skill User</li>

            </ul>
          </td>

        </tr>
        <tr class="">
          <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d112321e67 ">To create, edit, run, and share all skills in Skill Builder:</td>

          <td class="slds-cell-wrap" style="vertical-align:top;" headers="d112321e67 ">
            <p>AI Skill Manager permission set</p>
            <ul>
              <li>Skill User</li>

              <li>Skill Manager</li>

            </ul>
          </td>

        </tr>
      </tbody>
    </table>

The Skills page in Agentforce Coworker is where you find a skill and run it. Skill Builder is where you create the skill, add instructions and tools, and publish a version.

## Navigate the Skills Catalog

In the Coworker sidebar, click **Skills**. **My Skills** and **Browse** appear.

**My Skills** lists skills your agents can run. This tab contains skills you’ve added and skills an admin assigned to you. If My Skills is empty, click **Browse** to add new skills.

![Skills page with + New. The My Skills tab is selected. (1) Search, Any owner, Published, and Most relevant. (2) A skill card with the play icon, Add to My Skills toggle, and additional options menu. Each card shows the skill name, description, and owner, such as Owned by you.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/skill_builder_gtk_myskills.png)

## Searching and Filtering (1)

Use the search bar and filters at the top of the catalog to find skills quickly.

- Search: Type a keyword to search by skill name or description.
- Owner: Filter by **Any owner**, **Shared with me**, or **Owned by me**.
- Status: Filter by **Any status**, **Published**, or **Unpublished**.
- Sort: Sort results by **Most relevant**, **A to Z**, or **Last modified**.

## Skill Cards (2)

Each skill in the catalog is displayed as a card showing:

- Skill Name: The title of the skill.
- Description: A summary of what the skill does, so your agent can find and use it.
- Owner: Who created or owns the skill, such as **Owned by you**.

Each skill card has the following actions:

- **Use in chat**: Launches the skill in a Coworker chat session. Only available for published skills.
- **Remove from My Skills**: Removes the skill from your My Skills tab.
- **Share**: Makes the skill available to others. Only available to the skill owner.
- **Make a copy**: Creates a copy of the skill. The copy is named Copy of \[skill name\] and is owned by you.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_note.png)

Note Some actions may only be visible to the skill owner or users with the appropriate permissions.

**Browse** lists published skills available in your org that aren’t in My Skills. Adding or removing a skill from My Skills doesn’t delete the skill from the org.

![Skills page with + New. Browse is selected. Search, Any owner, Any status, and Most relevant appear above skill cards in two columns. Each card shows the skill name, description, and owner.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/skill_builder_gtk_browse.png)

Each skill card in Browse includes the following actions:

- **Use in chat**: Launches the skill in a Coworker chat session. Only available for published skills.
- **Add to My Skills**: Adds or removes the skill from your personal My Skills tab.
- **Share**: Makes the skill available to others, or reverts it to draft status. Only available to the skill owner.

## Navigate the Skill Builder UI

To edit an existing skill, click a skill card in **My Skills**.

![Skills page with + New. My Skills is selected. Last Updated Account Activity Summary is highlighted.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/skill_builder_gtk_select_card.png) ![Skill Builder for Account Health Check Summary, version V1. (1) Skill Settings open on Resources, with Inputs, Actions, Global, and Tools. (2) Instructions canvas with description, Target Agent set to Coworker, Purpose, and Steps. (3) Insert Resource. (4) Save, Save as a New Version, Unpublish, Run, and Added.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/skill_builder_gtk_builder.png)

Skill Builder includes:

- Configure Skill Settings (1): Resources (inputs, actions, and tools) and References (where the skill is being used).
- Instructions Canvas (2): Target Agent, Objective, Steps, Guidelines, Data & Tools, Examples.
- Insert Resource (3): Type `@` or `/`, or click **Insert Resource**.
- Versioning, availability and use (4): Version and availability actions.

## Configure Skill Settings (1)

Click the settings to open **Skill Settings**.

- Resources: Inputs, Actions, and Tools. Click the + icon to create new or select existing inputs or actions.
- References: Lists where the skill is being used.

![Skill Settings on the Resources tab, with search, Inputs, Actions, Global (Current Organization, Current User), and Tools (Salesforce). References is the other tab.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/skill_builder_gtk_settings.png)

## Instructions Canvas (2)

In the canvas, write an Objective or Purpose, Steps, Guidelines, Data & Tools, and Examples.

![Canvas for Account Health Check Summary showing the description, Target Agent set to Coworker, Details, Purpose, and numbered Steps. The header shows Save, Save as a New Version, Unpublish, Run, and Added.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/skill_builder_gtk_canvas.png)

## Insert Resource (3)

Click **Insert Resource** or type `@` to add context and agent actions to the instructions. Type `/` for conditionals, draft with AI, or formatting options.

![Menu grouped as AI (Draft with AI), Conditional (If Statement), and Basic Blocks (Paragraph, Big Heading, Medium Heading).](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/skill_builder_gtk_insert_slash.png) ![At-sign menu showing Tools and Salesforce.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/skill_builder_gtk_insert_at.png)

## Versioning, Availability and Use (4)

When the skill is ready:

- Click **Save** to save the current version.
- Click **Save as a New Version** to save as the next version of the skill.
- Click **Publish** to make that version of the skill available to share and ready to run.
- Click **Run** to test or manually trigger the skill in the builder.

![Skill Builder header with Save, Save as a New Version, Unpublish, Run, Added, settings, and the additional options menu.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/skill_builder_gtk_version_actions.png)

On a published skill card in My Skills or Browse, click **Use in chat** to run the skill in a Coworker chat.

![My Skills list. On Last Updated Account Activity Summary, the play icon is highlighted.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/skill_builder_gtk_use_in_chat.png)

From the additional options menu in the builder:

- **Make a Copy**
- **Delete Version**
- **Delete Skill**

![In Skill Builder the menu options are shown: Make a Copy, Delete Version, and Delete Skill.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/skill_builder_gtk_overflow_menu.png)

## Put Skills to Work

After you publish a skill, users run it from My Skills with `/` or by describing the task in plain language to an agent. Recipients add a shared skill from Browse.

#### See Also

- [How Users Work with a Skill](https://help.salesforce.com/s/articleView?id=ai.skill_builder_how_users_work.htm&release=264.0.0&type=5 "After you publish a skill, users run it from Use in chat, from a slash command, or by describing a task.")
- [Create a Skill in Agentforce Studio](https://help.salesforce.com/s/articleView?id=ai.skill_builder_create_studio.htm&release=264.0.0&type=5 "Create a skill in Skill Builder, and then add instructions and context.")
- [Create a Skill from Coworker](https://help.salesforce.com/s/articleView?id=ai.skill_builder_create_coworker.htm&release=264.0.0&type=5 "Create a skill from Agentforce Coworker by describing it in Ask mode.")
- [Write Skill Instructions](https://help.salesforce.com/s/articleView?id=ai.skill_builder_write_instructions.htm&release=264.0.0&type=5 "Write Markdown instructions that tell the AI model what to do, in what order, and how to use agent actions and context.")
- [Add Context to a Skill](https://help.salesforce.com/s/articleView?id=ai.skill_builder_add_context.htm&release=264.0.0&type=5 "Add reference data so the skill is grounded in your org at run time.")
- [Manage Skills](https://help.salesforce.com/s/articleView?id=ai.skill_builder_manage.htm&release=264.0.0&type=5 "Share skills and choose which published skills appear in My Skills.")
- [Skill Versions](https://help.salesforce.com/s/articleView?id=ai.skill_builder_versions.htm&release=264.0.0&type=5 "A skill version is a snapshot of a skill’s instructions and configuration. The published version is the one that runs.")
- [Copy a Skill](https://help.salesforce.com/s/articleView?id=ai.skill_builder_copy.htm&release=264.0.0&type=5 "Create a copy of a skill so that you own it and can edit it.")