v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-305398191.8 KB
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