Skip to main content
POST
Create Skill

Authorizations

Authorization
string
header
required

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

Query Parameters

genai_app
string
required

The name of the GenAI app (agent).

app_type
string
default:agent

The type of the app; must be 'agent'.

Body

application/json

Skill definition (name, description, content, etc.).

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

Response model for a single skill

skill
Skill · object
required

The skill data