Skills endpoints

List, create, update, and delete custom skills.

A skill is a reusable, named capability the agent can invoke — typically a prompt template plus optional helper scripts. The Engine ships a small catalog of platform skills (summarizer, fact-checker, code-reviewer, etc.) and lets you add your own. Custom skills live in the brain database and travel with memory exports.

GET /skills

List all skills available in the current Engine, platform and custom.

[
  {
    "name": "summarizer",
    "description": "...",
    "source": "platform" | "custom",
    "category": "...",
    "confidence": 0.95
  }
]

GET /skills/

Get the full definition of one skill.

{
  "name": "code-reviewer",
  "description": "...",
  "category": "engineering",
  "prompt_template": "...",
  "scripts": { "main.py": "..." },
  "capabilities": ["..."]
}

404 if no skill with that name.

POST /skills/create

Create a new custom skill.

POST /skills/create
Content-Type: application/json

{
  "name": "tweet-drafter",
  "description": "Draft a tweet in the user's voice.",
  "category": "communication",
  "prompt": "You are drafting a tweet...",
  "capabilities": ["writing"],
  "scripts": { "post.py": "..." }
}

Field	Type	Required	Purpose
name	string	yes	Unique name. Lowercase with hyphens.
description	string	no	Short summary.
category	string	no	Grouping (e.g. communication, engineering).
prompt	string	no	Prompt template. Required if no scripts.
capabilities	array	no	Tags.
scripts	object	no	Map of filename → contents.

Returns the created skill.

PUT /skills/

Update fields of an existing custom skill. Same body shape as create, all fields optional. Cannot rename — delete and recreate to rename.

DELETE /skills/

Delete a custom skill. Platform skills cannot be deleted; the call returns 403.

{ "status": "deleted", "name": "tweet-drafter" }

See also

• Defining tools for the difference between tools, skills, and MCP connectors.