API Reference

The template registry is backed by a small, public, read-only HTTP API. Agent-swarm workers and external tooling use it to fetch templates and assets as JSON. No authentication is required, and every endpoint sends permissive CORS headers (Access-Control-Allow-Origin: *), so it is safe to call directly from a browser.

Base URLhttps://templates.agent-swarm.dev

GET/api/templates

List everything in the registry

Returns every agent template and every asset (skills, schedules, workflows) in a single payload. Use this to mirror or index the full registry.

Example request

curl https://templates.agent-swarm.dev/api/templates

Response (shape)

{
  "templates": [
    {
      "name": "coder",
      "displayName": "Coder",
      "description": "...",
      "version": "1.0.0",
      "category": "official",
      "agentDefaults": { "role": "worker", "capabilities": ["core"], "maxTasks": 3 },
      "files": { "claudeMd": "CLAUDE.md", "soulMd": "SOUL.md", ... }
    }
  ],
  "assets": [
    {
      "kind": "skill",
      "name": "linear-interaction",
      "displayName": "Linear Interaction",
      "slug": "linear-interaction",
      "category": "skills",
      "version": "1.0.0",
      "placeholders": ["LINEAR_PROJECT_ID"],
      "must": true,
      "tags": ["linear", "tracker"]
    }
  ]
}

GET/api/templates/{category}/{name}

Fetch one template or asset (with file bodies)

Returns a single item by category and name, including its full content. For agent templates the response carries the resolved file bodies (CLAUDE.md, SOUL.md, …). For assets it carries the rendered markdown body (skill content, schedule task, or workflow definition).

Path parameters

category — Agent templates: "official" or "community". Assets: "skills", "schedules", or "workflows".
name — The slug of the template/asset, e.g. linear-interaction.

Example request

# An asset (skill / schedule / workflow)
curl https://templates.agent-swarm.dev/api/templates/skills/linear-interaction

# An agent template
curl https://templates.agent-swarm.dev/api/templates/official/coder

# Pin an agent template version (optional @version suffix)
curl https://templates.agent-swarm.dev/api/templates/official/coder@1.0.0

Response (shape)

// Asset response
{
  "config": { "kind": "skill", "name": "linear-interaction", "must": true, ... },
  "body": "# Linear Interaction\n\nThe swarm's Linear integration is..."
}

// Agent template response
{
  "config": { "name": "coder", "agentDefaults": { ... }, ... },
  "files": { "claudeMd": "...", "soulMd": "...", "toolsMd": "...", ... }
}

Notes & conventions

404
Unknown category/name returns { "error": "..." } with a 404 status.
versions
Agent templates accept an optional @version suffix; a mismatch returns 404 listing the available version.
assets
Workflow asset bodies embed a runnable workflow definition as a fenced ```json block — copy it straight into create-workflow.