Skip to main content
GET
Read skill source

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

Project slug, UUID, or domain that identifies the project.

skill_id
string
required

Skill identifier

Query Parameters

runtime_target_kind
enum<string> | null

Used as the source target kind when source_target_kind is omitted.

Available options:
main_branch,
environment,
preview_branch,
null
target_environment_id
string<uuid> | null

Not supported for source reads; a non-null value is rejected.

target_branch_id
string<uuid> | null

Preview branch UUID, for a preview_branch target.

source_target_kind
string

Source target: project or preview_branch. Defaults to project.

Response

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
instructions
string
required

The Markdown body of SKILL.md, excluding frontmatter.

sections
object
required

Read-only sections derived from ## headings in the body. Empty if the body cannot be split into sections. Use instructions for the complete, authoritative body; this field cannot be updated.

source
string
required
source_only_reasons
string[]
required
allowed_tools
string[]
owner_agent_id
string
short_name
string