skill_create
tools/call
Creates a new skill from its files, which must include SKILL.md with a name and description. The change is a draft: agents keep the approved version until the person approves the draft on the web. Refused when the name is taken; use skill_update to change a skill.
Scopes
read:skillswrite:skills
Inputs
- namestringRequired
- The skill's name, as skills_list shows it
- filesobject[]Required
- Every file of the skill
- idempotencyKeystringRequired
- A retry key you choose, 8 to 80 letters, digits or . _ : -; the same call sent again with it writes nothing new
Returns
The draft's version number and whether it can run code, or the checks it failed. A call returns content[0].text with the JSON result and structuredContent.result with the same value.
Listed when
The key was made in your personal workspace and holds the tool's scope.