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

200

{
  "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"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

Authorizations

Authorization · string · header · required

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

name · string · required

Immutable skill name. Lowercase letters, numbers, and single hyphens only.

Example:

"review-migrations"

description · string · required

Maximum string length: 1024

skill_md_body · string · required

version · string · required

Example:

"1.0.0"

license · string | null

compatibility · string | null

metadata · object

Show child attributes

extra_frontmatter · object

allowed_tools · string | null

files · object[]

Show child attributes

Response

200

application/json

Skill created successfully

skill · object

Skill repository entry and currently served version metadata.

Show child attributes