---
schema_version: "1"
id: ce96813670d64743993be2dce4b0cc4af4c1c307098b2740f6a74d7a12678cc7
title: Troubleshoot Skills
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/skill_builder_troubleshoot.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.skill_builder_troubleshoot.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 44509225eaf0ce161e7a9f1810c60c3541148c03404e2473eb0474bc422aaec1
description: Resolve common issues when a skill doesn’t appear or doesn’t run as expected.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Troubleshoot Skills

Resolve common issues when a skill doesn’t appear or doesn’t run as expected.

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

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

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

              <li>Skill Manager</li>

            </ul>
          </td>

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

## The skill doesn’t appear in the slash-command list

Confirm the following:

- The skill is published.
- The skill is in My Skills.
- The skill’s scope matches the current agent, such as Coworker.
- You have the AI Skill User permission set.

## The shared skill doesn’t appear in My Skills

If a shared skill doesn’t appear in My Skills, then open Browse and turn on **Add to My Skills**. Sharing grants access. It doesn’t add the skill to My Skills.

## Users can’t create skills

If users can’t create skills, then confirm that the AI Skill User or AI Skill Manager permission set is assigned, that the required add-on is provisioned, and that Einstein Generative AI is on.

## Skill Builder doesn’t load

If Skill Builder doesn’t load, then refresh the page, clear the browser cache, and confirm permissions. If the message We couldn’t load this skill appears, then confirm that you have access to the skill.

## The skill returns an inaccurate response

If the skill returns an inaccurate response, then make the instructions more specific, confirm agent actions and scope, and add context.

## Shared skill is read-only

If you can’t edit a skill that was shared with you, then the access is Read only. Ask the owner for Read and write, or click **Make a Copy**.

#### 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.")
- [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.")
- [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.")