$ man api — Docs · API

API reference

The v1 JSON API lets you query the published catalog programmatically. Generate a token in /dashboard/api — it starts with csk_ and is shown only once.

Authentication

Send your token as a Bearer header. Missing / revoked / malformed tokens return 401 or 403.

Authorization: Bearer csk_0123456789abcdef…

GET /api/v1/skills

List published skills. Supports sort (trending / new / top), limit (max 100), offset, category, tag.

curl -H "Authorization: Bearer $CSK_TOKEN" \
  "https://claudeskill.app/api/v1/skills?sort=top&limit=10"

{
  "ok": true,
  "total": 214,
  "limit": 10,
  "offset": 0,
  "results": [
    {
      "slug": "seo-content-optimizer",
      "title": "SEO Content Optimizer",
      "shortDescription": "…",
      "author": { "handle": "…", "name": "…" },
      "stars": 128,
      "installs": 4210,
      "categories": ["marketing"],
      "tags": ["seo","content"],
      "updatedAt": "2026-04-10T…"
    }
  ]
}

GET /api/v1/skills/:slug

Full skill detail including description, readme, and install CLI.

curl -H "Authorization: Bearer $CSK_TOKEN" \
  https://claudeskill.app/api/v1/skills/seo-content-optimizer

Rate limits

Soft-limited at 60 requests/minute per token. Exceeding the limit returns 429; back off and retry with jitter.

Errors

401 missing_bearer — no Authorization header.
401 invalid_token — token not recognized.
403 revoked_token — token was revoked.
404 not_found — slug is unknown or not yet published.