create_skill
Saves a new Markdown skill.
Content over 15,000 characters or with injection-like text is rejected.
- Tool name
- create_skill
- Group
- Skills
- Risk
- low
- Needs approval
- never
- Approval rule
- No approval.
- Allowed in scheduled jobs
- No
- Default
- on
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| name | string | Yes | A short name. | ||
| content | string | Yes | The text to store or write. | Memory notes are read back into prompts in slices of 4,000 characters (global) or 1,500 (session). | |
| use_case | string | No | One line about when to use the skill. | ||
| category | string | No | personal | Which group of skills or tools. | One of: personal, market, custom. |
Returns
A confirmation.
Example (made up for this page)
{
"name": "demo",
"content": "demo"
}Created personal/deploy-checklistSide effects
- Writes a file under skills/library.
How it can fail
| When | What the agent sees |
|---|---|
| Too long | Rejected with the limit |
| Flagged text | Rejected with the reason |
See also:Skills tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.