Skip to main content
A skill is a written procedure the agent loads when the task matches its description. It is a folder: a markdown body plus optional reference files. See Skills for the concept.

​
list_skills

​
string
required
Returns each skill with its slug, name, description and the list of reference files it carries.

​
get_skill

Reads one skill in full: its body and its reference files.
​
string
required
​
string
required

​
upsert_skill

Creates a skill, or replaces the one with the same name.
​
string
required
​
string
required
The skill name. The slug is derived from it.
​
string
required
The procedure, in markdown.
​
string
What makes the agent decide to load this skill, so state when to use it. This is the only line the agent sees before opening the skill.
​
string
The existing skill to update, when the name is changing too. Without it, a new name creates a second skill.
​
object[]
Reference documents the body can point to, which keeps the body short. Each entry needs path and content. Files already on the skill and not listed again are kept.
Request arguments
The whole skill is written in one atomic swap. If the call fails, nothing changed.

​
delete_skill

Deletes a skill and its reference files.
​
string
required
​
string
required
​
boolean
required
Must be true.