Skip to main content
POST
Create Skill

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

project_reference
string
required

Query Parameters

source_target_kind
string
target_branch_id
string<uuid> | null

Body

application/json
name
string
required

Canonical skill name, also used as the skill directory name. Max 64 characters. Lowercase letters, numbers, and hyphens only. Must not start or end with a hyphen, and must not contain consecutive hyphens.

Required string length: 1 - 64
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
description
string
required

Max 1024 characters. Non-empty. Describes what the skill does and when to use it.

Required string length: 1 - 1024
id
string

Deprecated alias for name; when sent it must equal name.

Required string length: 1 - 64
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
allowed_tools
string[]
Minimum string length: 1
sections
object
source
string
Minimum string length: 1

Response

Created project skill document

id
string
required
name
string
required
description
string
required
source_path
string
required
edit_mode
enum<string>
required
Available options:
structured,
source_only
sections
object
required
source
string
required
source_only_reasons
string[]
required
allowed_tools
string[]
owner_agent_id
string
short_name
string