# Claude Skills Hub — https://claudeskills.info

> A searchable directory of harness components for AI coding agents. We return objective facts
> and source links. Installation and selection are up to you — go to each result's source repo.

## Query API (read-only JSON, CORS: *, cached 5 min)

Search (deduped by source repo — one representative skill per repo, ranked by the repo's stars):
  GET https://claudeskills.info/api/v1/search?q={keywords}&category={optional}&limit={1-100,default 20}&offset={n}&sort={stars|newest}
  -> { "total": 128, "limit": 20, "offset": 0, "results": [ItemJSON, ...] }   // total = number of distinct repos matching

One item:
  GET https://claudeskills.info/api/v1/items/{slug}   -> ItemJSON  (404 if unknown)

Discover (counts, valid category values, sorts, data scope):
  GET https://claudeskills.info/api/v1/meta

ItemJSON:
  {
    "slug": "impeccable-design-polish",
    "name": "Impeccable Design Polish",
    "description": "Final quality pass for AI-generated frontend design.",
    "category": "design",
    "stars": 10579,
    "source": { "repo": "aiskillstore/marketplace", "url": "https://github.com/aiskillstore/marketplace" }
  }

## Notes for agents
- Every result has source.url — the authoritative repo. Read it there for how to install; we ship no install commands.
- Results are deduped by source repo: a repo with many skills (e.g. a large collection) appears once, as its top-star / first-slug entry. To see every skill in a repo, open source.url. `total` is the count of distinct matching repos.
- sort=stars ranks by the repo's real GitHub stars (default). sort=newest ranks by date added. There is no full-text relevance ranking yet.
- limit defaults to 20, max 100 (values are clamped, not rejected).
- Data scope: catalog skills harvested from public GitHub repos (~11k, real repo stars). Our featured/curated flagship picks are NOT yet in this index (coming in a later phase). Call /api/v1/meta for authoritative counts (total_items, unique_repos) and the scope string.
- Call /api/v1/meta first to learn valid `category` values before filtering.
- Human pages: https://claudeskills.info/skill/{slug} and https://claudeskills.info/catalog/{slug}.
- API URL note: this API lives at claudeskills.info/api/v1/. If it ever moves to api.claudeskills.info, this path will 301-redirect and keep working.