Create a skill

Creates a skill from a zip upload or a single-file JSON body

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Installs a skill into the project. Two request shapes, validated identically:

  • application/json{ name, description, content } for a single-file skill. The SKILL.md is assembled server-side.
  • multipart/form-data — a .zip with exactly one top-level directory containing SKILL.md. Limits: 5 MB compressed, 20 MB uncompressed, 100 files.

The zip shape is the one Download a skill returns, so a skill round-trips: download, edit, re-upload.

Re-using an existing skill name returns 409 — delete it first, or pick another name. Built-in skills cannot be overwritten. Frontmatter is validated, but no execution check is performed.

See Skills for the SKILL.md format and a worked example.

🔗

Learn more


Path Params
integer
required

Project ID.

Body Params
string
required

Lowercase kebab-case; also becomes the directory name.

string
required
string
required

Markdown body placed below the frontmatter.

Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json