skills

List or search skills

Search and browse reusable prompt-based skills. Supports full-text and semantic search via the q parameter, and filtering by category, namespace, or slug.

get/skills

Query parameters

qstring

Search query for full-text and semantic search across skill names and descriptions.

categorystring

Filter by skill category (e.g. 'code', 'data', 'web').

namespacestring

Filter by the namespace that owns the skill.

slugstring

Filter by exact skill slug within a namespace. Deprecated: use GET /skills/:namespace/:slug instead.

ownerIdstring

Filter by the skill owner's organization ID.

verifiedboolean

Filter by whether the skill's namespace is verified.

pageinteger

Page number (1-indexed).

pageSizeinteger

Number of results per page (default 20, max 100).

topKinteger

Maximum number of candidate results to consider from the search index before pagination. The server applies a hard cap of 500 to keep the rerank window bounded; pass seed for stable deep pagination.

fieldsstring

Comma-separated list of fields to include in response

seedinteger

Random seed for deterministic pagination. When provided, results use a stable sort order that is consistent across pages for the same seed value.

Response

Successful response

Changes

Changed in 6 of the 47 revisions of this API.138

May 8, 2026fac0cbc24c1d1See the full diff
- ○
  added the new optional query request parameter seed
  new-optional-request-parameter
Apr 12, 202601f97a60fd963See the full diff
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 13, 202643d4f10825441See the full diff
- ▲
  response property skills/items/gitUrl list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
Feb 7, 202675ad67fea2c12See the full diff
- ○
  added the new optional query request parameter verified
  new-optional-request-parameter
- ○
  added the required property // to the response with the status
  response-required-property-added
Feb 5, 20269d53933ba12e3See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 4, 20260ea2d8e23fa12See the full diff
- ○
  added the new optional query request parameter fields
  new-optional-request-parameter
- ○
  added the new optional query request parameter ownerId
  new-optional-request-parameter

Full history