Create Skill
create_skillCreate a new skill from a blank slate (origin: user_authored) — requires Pro Plus. Pro can fork an existing skill instead with fork_skill. description is required (1-1024 chars) — it is the only signal an agent uses to decide when to load the skill, so name specific trigger phrases and a "do NOT use for..." case.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"scope": "<scope>",
"name": "<name>",
"description": "<description>",
"body": "<body>"
},
"name": "create_skill"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Plain CommonMark instructions — no templating or interpolation | |
| name | Yes | Kebab-case, <= 64 chars, e.g. "my-writing-style" | |
| scope | Yes | ||
| title | No | ||
| auto_load | No | ||
| description | Yes | Required, 1-1024 chars — the sole signal an agent uses to decide when to load this skill | |
| project_key | No | Required when scope is "project" |