Skills

Search published skills via the CLI's account-key auth

Account-authenticated skill search. Returns a slim list view (no inline file content) — clients that need full SKILL.md should follow up with GET /api/v1/skills/{owner}/{name}.

Delegates to the same underlying query as the catalog-key /api/v1/catalog/skills endpoint. This route exists so the CLI can search without requiring a separate catalog key.

The sort query param is parsed leniently — unknown values silently fall back to popular rather than returning 400. Don't rely on the fallback; use one of the listed values.

get/api/v1/skills/search

Request

  • Base URL: https://skillrepo.dev
  • URL: https://skillrepo.dev/api/v1/skills/search
  • Auth: HTTP bearer

Query parameters

qstring

Free-text search across name, description, and owner.

sort'name' | 'popular' | 'recent' | 'top-rated' | 'grade' | 'relevance'

Sort order for the catalog list endpoint. grade orders by safety grade A→F with ungraded skills last; relevance is hybrid semantic ranking (keyword + vector similarity) and falls back to popular when no q is supplied. With a q, other sorts re-rank within the relevant set.

Sort order (default popular). Unknown values silently fall back to popular.

limitinteger

Items per page, 1-100 (default 20).

offsetinteger

Zero-based offset into the result set (default 0).

Response

Search results.

Changes

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