Kits

Kits share the @org/slug namespace with skills. Every active org member can create and curate kits; deleting is admin+. Rules: Kits.

`GET /kits`

Kits across all the user’s organizations.

// 200
{
  "kits": [
    {
      "name": "@acme/ai-team",
      "org": "acme",
      "slug": "ai-team",
      "displayName": "AI team baseline",
      "description": "…",
      "visibility": "private",
      "skillCount": 3,
      "updatedAt": "2026-08-10T12:00:00Z"
    }
  ]
}

`POST /kits`

Create a kit from a list of skill names.

// request
{
  "org": "acme",                       // optional; defaults to the device's org
  "slug": "ai-team",
  "displayName": "AI team baseline",   // optional; defaults to the slug
  "description": "…",                  // optional
  "visibility": "private",             // optional; default private
  "skills": ["@acme/api-conventions", "@acme/review-checklist"]   // 1–50 names
}

Status	Code	Meaning
`200`	—	`{ kit }` with the resolved skill list
`409`	`slug_taken`	The name already belongs to a skill or kit in that namespace
`422`	`unknown_skills`	Listed skills that don’t exist or aren’t visible to the caller

`GET /kits/:org/:slug`

Kit detail with its skills — entitlement-filtered: skills the caller can’t see are omitted, so the list is exactly what an install would deliver. The CLI installs kits by walking this list.

`PATCH /kits/:org/:slug`

Update metadata and/or contents. Requires membership in the owning org.

// request — all fields optional
{
  "displayName": "AI team baseline",
  "description": "…",
  "visibility": "private",
  "skills": ["@acme/api-conventions", "@acme/booking-flow-rules"]
}

When skills is present it replaces the kit’s contents wholesale (1–50 names; 422 unknown_skills applies). Returns the updated kit view.

`DELETE /kits/:org/:slug`

Archives the kit. Admin or owner only — members get a 403. The skills inside are untouched; idempotent.

// 200
{ "archived": true, "name": "@acme/ai-team" }

API

Endpoints

`GET /kits`

`POST /kits`

`GET /kits/:org/:slug`

`PATCH /kits/:org/:slug`

`DELETE /kits/:org/:slug`

​GET /kits

​POST /kits

​GET /kits/:org/:slug

​PATCH /kits/:org/:slug

​DELETE /kits/:org/:slug

`GET /kits`

`POST /kits`

`GET /kits/:org/:slug`

`PATCH /kits/:org/:slug`

`DELETE /kits/:org/:slug`