Skills endpoints

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" }

Get started

Capabilities

Build with the Engine

Agents and tools

Test and evaluate

API reference

Guides

Resources

Skills endpoints

GET /skills

GET /skills/

POST /skills/create

PUT /skills/

DELETE /skills/

See also

​GET /skills

​GET /skills/

​POST /skills/create

​PUT /skills/

​DELETE /skills/

​See also

GET /skills

GET /skills/

POST /skills/create

PUT /skills/

DELETE /skills/

See also