Skip to main content
POST

Authorizations

Authorization
string
header
default:cr_sk_your_key_here
required

Account API key from Developer Console. Keys start with cr_sk_.

Body

application/json
source
enum<string>
required
Available options:
github,
content
source_url
string

Required when source is github.

Maximum string length: 1024
content
string

SKILL.md text. Required when source is content.

Maximum string length: 262144
files
object

Supporting files. Combined size must be 5 MB or smaller.

name
string
Maximum string length: 64
description
string
Maximum string length: 2000
tags
string[]
Maximum array length: 10
Maximum string length: 50
enabled
boolean
default:true

Response

Existing custom skill updated.

skill_id
string
required

Public skill id. Custom skills use custom-{name}.

kind
enum<string>
required
Available options:
builtin,
custom
name
string
required
display_name
string
required
description
string | null
required
enabled
boolean
required
core
boolean
required
source_url
string | null
required
tags
string[]
required
created_at
string<date-time> | null
required
updated_at
string<date-time> | null
required
id
string<uuid> | null

Custom-skill row UUID. Null for built-ins. Read-only metadata; not used in paths.

content
string

SKILL.md body. Present on GET and install, omitted from list.

files
object | null

Supporting files for custom skills. Present on GET and install.