Skip to main content
POST
Create a skill (or a new version of one)

Authorizations

Authorization
string
header
required

API key with the vk_ prefix. Create one from the dashboard.

Body

application/json
name
string
required

[a-z0-9][a-z0-9_-]{0,63}. Reusing a name creates the next version.

instructions
string
required

The SKILL.md body (Markdown). At most 256 KiB.

description
string | null

One line the harness uses to decide when the skill applies.

allowed_tools
string[]

Advisory tool allowlist written into the skill's frontmatter.

Response

The new skill version

object
string
required
id
string
required
name
string
required
description
string
required
instructions
string
required
allowed_tools
string[]
required
version
integer<int32>
required
created_by
string
required
created_at
string<date-time>
required