Plain text · sha256 a58970596b9b
The description, line by line
9 lines Line numbers are v2.1.278 on the left and this capture on the right.
1
1
Invoke a skill.
2
2
3
3
A skill is a packaged set of instructions the user or project has set up for a particular kind of task (deploy steps, a review checklist, a repo-specific workflow). Available skills appear in a system-reminder listing with one-line descriptions. When the task at hand is one a listed skill covers, call this tool first — the skill's instructions load into the turn for you to follow in place of your default approach; some skills instead run in a subagent and return the finished result. A skill that runs in the background returns only the agent's name — its result arrives later as a task notification, so don't wait on it or invoke it again in the meantime. Users may also ask for one by name (`/<name>`, or "slash command"); that's a request to invoke it.
4
4
5
5
- `skill`: exact name from the listing, no leading slash. Plugin skills use `plugin:skill`. Directory-scoped skills are listed with a path prefix (`apps/web:deploy`); when both scoped and unscoped variants of a name exist, pick the one whose directory contains the files you're working on (most specific wins; unscoped otherwise).
6
6
- `args`: optional arguments to pass through.
7
7
8
8
Only names from the listing (or that the user typed explicitly) are valid. Built-in CLI commands (`/help`, `/clear`, …) aren't skills. If a `<command-name>` block is already present this turn, the skill is loaded — follow it directly rather than calling again.
9
9
What it accepts
2 parameters The JSON parameter schema sent beside this description, 384 characters of it. Name, type, then whether the client marked it required.args
string
optional
Optional arguments for the skill
skill
string
required
The name of a skill from the available-skills list. Do not guess names.
sha256 5458f6a48156 · the schema as the client sent it:
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"args": {
"description": "Optional arguments for the skill",
"type": "string"
},
"skill": {
"description": "The name of a skill from the available-skills list. Do not guess names.",
"type": "string"
}
},
"required": [
"skill"
],
"type": "object"
}