Library

Get a single library entry

Returns one skill from the authenticated account's library. Includes own private skills and skills added from the catalog via POST /api/v1/library/refs.

Status codes:

  • 200 — skill is past safety analysis and ready to consume.
  • 202 — caller owns a skill whose safety analysis is still running (RFC 9110 §15.3.3). Retry after the interval in Retry-After. Non-owners do not get this response.
  • 404 — skill not in the caller's library and not owned by the caller, OR a moderation/visibility filter applied. Single message across all 404 paths to avoid leaking skill existence to other accounts.

Cache-Control:

  • no-store on 202.
  • private, no-store on 200 when skill.filesIncomplete is true.
  • private, max-age=0, must-revalidate on complete 200 — limits storage to the caller's own browser cache and forces revalidation on every request.

Rate-limit bucket: cli-crud (60/min per key).

get/api/v1/library/{owner}/{name}

Request

  • Base URL: https://skillrepo.dev
  • URL: https://skillrepo.dev/api/v1/library/{owner}/{name}
  • Auth: HTTP bearer

Path parameters

ownerstring required
namestring required

Response

Skill found and past safety analysis.

Example response

{
  "skill": {
    "files": [
      {
        "contentType": "text/markdown"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.