Skip to main content

Documentation Index

Fetch the complete documentation index at: https://septemberai.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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": "..." }
}
FieldTypeRequiredPurpose
namestringyesUnique name. Lowercase with hyphens.
descriptionstringnoShort summary.
categorystringnoGrouping (e.g. communication, engineering).
promptstringnoPrompt template. Required if no scripts.
capabilitiesarraynoTags.
scriptsobjectnoMap 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.