Skip to main content
POST
Create a custom skill

Authorizations

x-api-key
string
header
required

Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key:

Body

application/json
name
string
required

Display name

Maximum string length: 200
Example:

"Invoice follow-up"

description
string
required

WHAT + WHEN for skill discovery (max 1024 chars)

Maximum string length: 1024
Example:

"Draft a polite follow-up when an invoice is 7 days overdue."

instructions
string
required

SKILL.md body (markdown instructions)

Example:

"# Invoice follow-up\n\n1. Load the invoice\n2. Draft a reminder email\n"

slug
string

Slug (lowercase alphanumeric + hyphens). Auto-generated from name if omitted.

Maximum string length: 64
Example:

"invoice-follow-up"

category
string

Optional category for browsing My Skills

Maximum string length: 64
Example:

"finance"

tags
string[]

Free-form tags (max 20)

Example:
suggestedToolSlugs
string[]

Known tool slugs for this playbook (skip DISCOVER → GET_TOOL_SCHEMAS). Not merged onto agents.

Example:
isPublic
boolean
default:false

If true, other projects in this workspace can discover the skill

Example:

false

version
string
default:1.0.0

Semver-style skill version

Maximum string length: 32
Example:

"1.0.0"

Response

200 - application/json

Operation completed successfully

success
boolean
required

Success status

Example:

true

message
string
required

Success message

Example:

"Operation completed successfully"

data
object
required
Example: