Skills API

GET /v1/skills

List skills by status.

Query parameters:

• status — proposed | promoted | deprecated (default: all)

Response:

{
  "skills": [
    {
      "id": "uuid",
      "name": "competitive-analysis",
      "description": "Research 3+ competitors and produce a structured comparison",
      "status": "proposed",
      "version": 1,
      "createdAt": "2026-04-18T..."
    }
  ]
}

---

PATCH /v1/skills/:id/promote

Promote a proposed skill to active. Requires admin.manage_templates.

Effect: Status changes proposed → promoted. The skill is written to SKILL.md in the sandbox so agents can reference it.

---

PATCH /v1/skills/:id/deprecate

Deprecate a skill. Requires admin.manage_templates.

Effect: Status changes proposed | promoted → deprecated. Agents no longer receive this skill in their context.