Skills
Skills
SKILL.md instruction bundles the workspace's agents load as context: list, create, edit files, validate, publish, toggle, and revert.
A skill is a SKILL.md bundle in the Agent Skills format: frontmatter (name, description) plus instructions, with optional scripts/, references/, and assets/. It is never executed. Agents load it by name when its description matches the task.
AuthenticationRequires
skills:manage on a personal API key. A CLI session always passes.Skill ids are skl_…. Two ways to change files: save one file inline for small edits, or push a whole bundle through a presigned upload then validate and publish, which is how the CLI works and the only way to carry binary assets.
Concurrency
Skills carry a version counter. Writes that race another writer answer 409; refetch and retry.
Endpoints
| Endpoint | Does |
|---|---|
GET /v1/skills | Workspace skills plus the platform catalog |
POST /v1/skills | Create a draft |
GET /v1/skills/:id | Detail |
PATCH /v1/skills/:id | Rename or change the description |
DELETE /v1/skills/:id | Archive |
PATCH /v1/skills/:id/enabled | Enable or disable |
GET /v1/skills/platform/:name | A platform skill's files |
GET /v1/skills/:id/files | The published bundle's files |
PUT /v1/skills/:id/files | Save one file and republish |
GET /v1/skills/:id/bundle-url | Presigned download of the live bundle |
POST /v1/skills/:id/bundle-upload-url | Presigned upload for a staged bundle |
POST /v1/skills/:id/validate | Validate a staged bundle |
POST /v1/skills/:id/publish | Publish a staged bundle |
GET /v1/skills/:id/versions | Version history |
POST /v1/skills/:id/versions/:versionId/revert | Revert to a version |