Skills - MasterSkills

`GET /skills?q=<query>`

The catalog across all the user’s organizations, optionally filtered.

// 200
{
  "skills": [
    {
      "name": "@acme/api-conventions",
      "org": "acme",
      "slug": "api-conventions",
      "displayName": "API conventions",
      "description": "REST and error-shape rules for all Acme services",
      "visibility": "private",
      "isRequired": false,
      "latestVersion": { "number": 4, "contentHash": "…", "sizeBytes": 34816, "fileCount": 6 },
      "installCount": 12,
      "archivedAt": null
    }
  ]
}

latestVersion is null for a skill with no published version yet.

`GET /skills/:org/:slug`

Full detail with version history. Private skills require membership in the owning org; public skills resolve for any signed-in device.

// 200
{
  "name": "@acme/api-conventions",
  "org": "acme",
  "slug": "api-conventions",
  "displayName": "API conventions",
  "description": "…",
  "visibility": "private",
  "isRequired": false,
  "archivedAt": null,
  "versions": [
    {
      "number": 4,
      "contentHash": "…",
      "sizeBytes": 34816,
      "fileCount": 6,
      "createdAt": "2026-08-01T10:00:00Z",
      "yankedAt": null
    }
  ]
}

`GET /skills/:org/:slug/versions/:number/download`

A short-lived, presigned download URL for one version’s package.

// 200
{ "url": "https://…", "contentHash": "…" }

Clients must verify the downloaded package’s sha256 against contentHash before writing anything to disk — the CLI aborts on mismatch, and so should you.

`DELETE /skills/:org/:slug`

Archives the skill org-wide — the operation behind masterskills unpublish and the panel’s archive action. Requires membership; idempotent.

// 200
{ "archived": true, "name": "@acme/legacy-deploy" }

Devices still holding the skill learn via /sync’s removed group.

​GET /skills?q=<query>

​GET /skills/:org/:slug

​GET /skills/:org/:slug/versions/:number/download

​DELETE /skills/:org/:slug

`GET /skills?q=<query>`

`GET /skills/:org/:slug`

`GET /skills/:org/:slug/versions/:number/download`

`DELETE /skills/:org/:slug`