API Reference

Create a skill

A named, described markdown document the model pulls in when relevant.

POST/routines/skillsadmin, user

description is what a run's model sees in the skills catalog when deciding whether to load this skill — keep it short and relevance-scoped. content is markdown, up to 16KB.

Body

namestringrequired

Non-empty, ≤128 chars, no slashes or control characters.

descriptionstringrequired

Non-empty. What the model sees when deciding whether to load this skill.

contentstringrequired

Markdown, up to 16KB (UTF-8 bytes).

Request

cURL

bash

curl -X POST localhost:8000/routines/skills \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"name":"sql-injection-review","description":"How to spot SQL injection in raw-query code paths.","content":"# SQL injection review\n\n..."}'

Responses

201Skill created

json

{ "id": 1, "name": "sql-injection-review", "description": "...", "content": "..." }

400Validation failure

json

{ "detail": "description must not be empty" }

409Name already exists

json

{ "detail": "skill 'sql-injection-review' already exists" }

← PreviousList skills Next →Get a skill