> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sourcebot.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

These tools need an authenticated user (API key or OAuth) and the Ask Sourcebot feature. Repository-scoped access tokens cannot use them.

## `create_skill`

You can create an agent skill: a reusable set of instructions you invoke in Ask Sourcebot as a `/<slug>` slash command, or that the agent loads automatically when your request matches its description. The skill is personal to you and enabled immediately. The result includes a link to the skill in **Settings → Skills**.

Parameters:

| Name | Required | Description |
| :- | :- | :- |
| `name` | yes | Display name for the skill (1-80 characters). |
| `slug` | yes | Slash command for the skill, without the leading `/`. Lowercase letters, numbers, and hyphens; at most 64 characters. Must be unique among the user's skills. |
| `description` | yes | When to use the skill (1-500 characters). Used by the agent to auto-load the skill. |
| `instructions` | yes | Markdown instructions the agent follows when the skill is invoked (1-20,000 characters). |

## `update_skill`

You can edit an existing skill in place. Fields you omit keep their current values. You can edit your personal skills, and shared skills only if you created them and they are enabled. Skills synced from a repository file are rejected; edit those in **Settings → Skills**. This tool never enables or disables a skill, and never moves it between the personal and shared catalogs.

Parameters:

| Name | Required | Description |
| :- | :- | :- |
| `slug` | yes | Current slash command of the skill to update, without the leading `/`. |
| `scope` | yes | Which catalog the skill lives in: `personal` or `shared`. |
| `name` | no | New display name (1-80 characters). |
| `newSlug` | no | New slash command, without the leading `/`. Lowercase letters, numbers, and hyphens; at most 64 characters. |
| `description` | no | New description of when to use the skill (1-500 characters). |
| `instructions` | no | New markdown instructions (1-20,000 characters). |

## `list_skills`

You can list the skills visible to you: your personal skills plus your organization's shared catalog. Each row includes `slug` and `scope` (the pair `update_skill` needs), `enabled`, `isSynced` (linked to a repository file), `canEdit` (whether `update_skill` can edit it), and, on shared rows, `adopted`. Skill instructions are never included.

Parameters:

| Name | Required | Description |
| :- | :- | :- |
| `scope` | no | Filter to one catalog: `personal` or `shared`. Omit to list both. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.