Error
A valid request URL is required to generate request examples{
"skill": {
"id": "<string>",
"name": "review-migrations",
"description": "Reviews database migration safety and rollback behavior.",
"license": "MIT",
"compatibility": "Claude Code, Codex",
"metadata": {},
"extra_frontmatter": {},
"allowed_tools": "<string>",
"skill_md_body": "<string>",
"latest_version": "1.0.0",
"created_by": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"files": [
{
"path": "references/style-guide.md",
"mime_type": "text/markdown",
"content": "<string>",
"source_url": "<string>",
"dataurl": "data:text/plain;base64,SGVsbG8=",
"upload_id": "<string>",
"storage_key": "<string>",
"blob_id": "<string>",
"id": "<string>",
"skill_version_id": "<string>",
"file_size_bytes": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"file_count": 123,
"highest_version": "1.2.0"
}
}Skills
Create skill
Creates a new skill and immediately serves its first immutable version.
POST
/
api
/
skills
Error
A valid request URL is required to generate request examples{
"skill": {
"id": "<string>",
"name": "review-migrations",
"description": "Reviews database migration safety and rollback behavior.",
"license": "MIT",
"compatibility": "Claude Code, Codex",
"metadata": {},
"extra_frontmatter": {},
"allowed_tools": "<string>",
"skill_md_body": "<string>",
"latest_version": "1.0.0",
"created_by": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"files": [
{
"path": "references/style-guide.md",
"mime_type": "text/markdown",
"content": "<string>",
"source_url": "<string>",
"dataurl": "data:text/plain;base64,SGVsbG8=",
"upload_id": "<string>",
"storage_key": "<string>",
"blob_id": "<string>",
"id": "<string>",
"skill_version_id": "<string>",
"file_size_bytes": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"file_count": 123,
"highest_version": "1.2.0"
}
}Authorizations
Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>.
Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.
Body
application/json
Immutable skill name. Lowercase letters, numbers, and single hyphens only.
Example:
"review-migrations"
Maximum string length:
1024Example:
"1.0.0"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
Skill created successfully
Skill repository entry and currently served version metadata.
Show child attributes
Show child attributes
Was this page helpful?
⌘I

