Update a skill
Update a skill. Omitted fields keep their current value. When instructions is provided it fully replaces the body of the skill’s SKILL.md file; name/description changes are also synced into the SKILL.md frontmatter. Built-in nuwacom skills cannot be updated.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
ID of the space the skill belongs to.
2 - 6Unique ID of the skill.
Body
Display name of the skill.
1 - 64^[\p{L}\p{N}][\p{L}\p{N} -]*[\p{L}\p{N}]$|^[\p{L}\p{N}]$Short description of what the skill does. The AI uses it to decide when to load the skill.
1 - 1024Markdown instructions for the AI, stored as the body of the skill's SKILL.md file.
50000Response
Skill updated successfully.
Unique ID of the skill. Use it to attach the skill to agents.
ID of the space the skill belongs to.
2 - 6URL-safe, immutable identifier generated from the initial name.
How the skill was created. Skills created via this API have source "manual".
manual, upload, github, ai_generated Source URL for skills imported from GitHub, null otherwise.
Markdown instructions from the body of the skill's SKILL.md file. null when the file cannot be read.