Skip to main content
GET
Get one skill

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.

Path Parameters

key
string
required

The skill's key, from GET /v1/skills

Maximum string length: 64

Response

200 - application/json

Successful Response

description
string
required

What an agent reads every turn to decide when to use it

enabled
boolean
required

Whether agents in this workspace load it

files
SkillFile · object[]
required

Its files, without the instructions; text ones are read with GET /v1/skills/{key}/file

has_tools
boolean
required

It carries tools of its own: over this API it only turns on or off

instructions
string
required

What the agent follows when it uses the skill (Markdown)

key
string
required

Fixed when the skill is made: the name agents call it by

name
string
required
parent_addendum
string | null
required

Added to the calling agent's instructions while it has a skill that runs in a sub-agent

run_in_sub_agent
boolean
required

The agent hands the skill to a sub-agent rather than following it itself

source
enum<string>
required

statisfy (shipped by Statisfy: read-only, but each workspace can turn it off) or workspace (this workspace's own)

Available options:
statisfy,
workspace
status
enum<string>
required

The skill's own state. A Statisfy skill turned off by this workspace stays enabled here: see enabled

Available options:
enabled,
disabled,
archived
used_by
SkillAgent · object[] | null
required

Every agent it is set on (archived agents left out). Changing a skill in use needs 'skills:publish'. Null when a change saved but its agents could not be read: read the skill again

version
integer | null
required

The live version, what a change or POST /v1/skills/{key}/live sends back as expected_version. Null when storage could not be read