Skip to main content
POST

Authorizations

Authorization
string
header
required

API key starting with sk_case_

Body

application/json

Skill definition

name
string
required

Skill name

Required string length: 1 - 256
content
string
required

Full skill content in markdown

Required string length: 1 - 65536
slug
string

URL-safe slug. Auto-generated from name if omitted.

Maximum string length: 128
summary
string

Brief description (1-2 sentences)

Maximum string length: 1000
tags
string[]

Tags for categorization and search boosting

metadata
object

Arbitrary metadata (author, license, etc.)

files
object[]

Optional bundled companion files installed alongside the skill as / in sandbox skill directories.

Maximum array length: 100

Response

Skill created

slug
string
name
string
summary
string | null
content
string
tags
string[]
metadata
object
bundle
object | null
version
integer
created_at
string<date-time>