POST
Create a skill

Authorizations

x-api-key
string
header
required

Headers

x-bma-project-id
string

Project scope. Required when the API key can access more than one project (alias: anthropic-workspace-id).

Idempotency-Key
string

Replays the first result of a create; the same key with another body is 409.

Required string length: 1 - 255

Body

multipart/form-data
files
file[]
required

One part per file; the part's filename is its path. All files share one top-level directory with a SKILL.md.

archive
file

A ready zip, instead of files.

display_name
string

Must equal the SKILL.md name when sent (400 otherwise).

Required string length: 1 - 255
bma_owner
string

Owner as JSON; defaults to the current project.

Response

Success.

id
string
required
type
string
required
Allowed value: "skill"
display_name
string
required
latest_version_id
string
required
source
object
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
bma_name
string
required

The machine-readable skill name from SKILL.md.

bma_revision
integer
required
Required range: x >= 1
bma_description
string
required
bma_owner
object
required

Who owns the skill .

bma_skill_md
string

Single read only.

bma_files
object[]

Single read only.