Create A Skill Version

Creating a skill version is part of the public beta skill surface.

Route

POST /api/skills/:id/versions

Auth

• auth mode: api_key_or_access_token
• user permission: ai.use
• API-key scope: skills:write

Workflow

1. Create or select a skill.
2. Post a new version to POST /api/skills/:id/versions.
3. Compose the draft version with POST /api/skill-versions/:id/prompts.
4. Re-read GET /api/skills/:id to inspect the returned promptComposition.
5. Preview with POST /api/skills/:id/preview.
6. Publish with POST /api/skills/:id/publish when ready.

Prompt composition is the public beta authored path for skill instructions. Use replacePrompts in the SDK or skills[].promptComposition in CLI desired state.

See also

• Prompt And Skill Quickstart
• Publish A Version
• Skills