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",
        "source_type": "url",
        "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

ManagementBearerAuthBasicAuth

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <token>, where <token> is one of:

• a Bifrost management API key,
• a dashboard session token issued by POST /api/session/login,
• base64 of <admin-username>:<admin-password> (legacy equivalent of BasicAuth).

Virtual keys (sk-bf-*) and the x-api-key header are not accepted on management APIs - the sole exception is GET /api/governance/virtual-keys/quota, which is virtual-key-only.

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