---
schema_version: "1"
id: 4a3a27302215173009c5022c292e511fc66c1acf85d424f1fc2710e92f0facea
title: Skill Builder Considerations
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/skill_builder_considerations.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.skill_builder_considerations.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 2d29fafb96a8293e67bb8ca7a8a622225a48da86c9ba4e239d74caa08e3dfffa
description: Considerations for building, sharing, running, and deploying skills.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Skill Builder Considerations

Considerations for building, sharing, running, and deploying skills.

### 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="d137468e67">User Permissions Needed</th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d137468e67 ">To create, edit, run, and share your own skills in Skill Builder:</td>

          <td class="slds-cell-wrap" style="vertical-align:top;" headers="d137468e67 ">
            <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="d137468e67 ">To create, edit, run, and share all skills in Skill Builder:</td>

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

              <li>Skill Manager</li>

            </ul>
          </td>

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

## Build and test

- Start with a simple skill: one task. Add agent actions after the instructions.
- Write a specific description so that natural-language matching can find the skill.
- In Guidelines, state what not to do, especially when agent actions change data.
- Make the skill available in Agentforce Coworker if it needs Coworker connections such as Slack or Google Drive.
- If a skill returns an inaccurate response, make the instructions more specific and add context. If the problem continues, then share the details with Salesforce Customer Support.

## Share and run

- Skills are private by default until shared. Share access is Read only or Read and write.
- Sharing grants access. It doesn’t add the skill to My Skills.
- Assign the AI Skill User permission set so that users can run skills they can access.
- A skill appears in the slash-command list when it’s published, in My Skills, and the skill is configured to point to that target agent.
- Unpublish stops runs and removes the skill from My Skills.

## Limits

- Skills run as the running user. Object permissions, field-level security, and sharing rules apply.
- Skills aren’t available on mobile.
- Multi-language instructions aren’t supported.
- Scheduled or event-driven skill runs aren’t supported.
- One skill doesn’t run another skill.

## Versions

- To keep a snapshot, click **Save as a New Version**.
- The published version is the one that runs.

## Deployment

- Skills deploy as metadata through Salesforce CLI, change sets, and unlocked packages.
- Retrieve returns one version: the published version, or the latest version if none is published.
- Deploy adds a version. It doesn’t overwrite existing versions.
- My Skills membership doesn’t deploy. Users in the destination org add skills from Browse.
- First-generation managed packages aren’t supported. Standard skills can’t be retrieved or packaged.

#### See Also

- [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.")
- [Give Users Access to Skills](https://help.salesforce.com/s/articleView?id=ai.skill_builder_give_users_access.htm&release=264.0.0&type=5 "Assign AI Skill User or AI Skill Manager, and then decide who can use each skill.")
- [Troubleshoot Skills](https://help.salesforce.com/s/articleView?id=ai.skill_builder_troubleshoot.htm&release=264.0.0&type=5 "Resolve common issues when a skill doesn’t appear or doesn’t run as expected.")