Skip to main content
POST
Skill Create

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Example: 'Authorization: Bearer {token}'

Body

application/json
name
string
required

Name of the skill

description
string
required

Description of the skill

content
string
required

Full SKILL.md content

license
string
default:""

Optional license field

compatibility
string
default:""

Optional compatibility field

metadata
Metadata · object

Optional metadata dict

allowed_tools
string
default:""

Optional allowed-tools field

status
string
default:active

Status of the skill: active or disabled

scripts
Scripts · object | null

Optional scripts/ files: path -> content (per Agent Skills spec)

references
References · object | null

Optional references/ files: path -> content (per Agent Skills spec)

assets
Assets · object | null

Optional assets/ files: path -> content (per Agent Skills spec)

Response

Successful Response

id
string
required

Unique identifier for the skill

name
string
required

Name of the skill

description
string
required

Description of the skill

content
string
required

Full SKILL.md content

created_by
string
required

User who created the skill

created_at
string<date-time>
required

The date and time when the skill was created.

updated_at
string<date-time>
required

The date and time when the skill was last updated.

license
string
default:""

License field

compatibility
string
default:""

Compatibility field

metadata
Metadata · object

Metadata dict

allowed_tools
string
default:""

Allowed-tools field

status
string
default:active

Status of the skill: active or disabled

scripts
Scripts · object | null

Optional scripts/ files (path -> content)

references
References · object | null

Optional references/ files (path -> content)

assets
Assets · object | null

Optional assets/ files (path -> content)