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

JavaScript

JavaScript

import Smithery from '@smithery/api';

const client = new Smithery({
  apiKey: process.env['SMITHERY_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const skillListResponse of client.skills.list()) {
  console.log(skillListResponse.id);
}

200

{
  "skills": [
    {
      "id": "<string>",
      "namespace": "<string>",
      "slug": "<string>",
      "displayName": "<string>",
      "description": "<string>",
      "prompt": "<string>",
      "qualityScore": 123,
      "verified": true,
      "listed": true,
      "createdAt": "<string>",
      "externalStars": 123,
      "externalForks": 123,
      "totalActivations": 123,
      "uniqueUsers": 123,
      "categories": [
        "<string>"
      ],
      "servers": [
        "<string>"
      ],
      "gitUrl": "<string>"
    }
  ],
  "pagination": {
    "currentPage": 0,
    "pageSize": 0,
    "totalPages": 0,
    "totalCount": 0
  }
}

Authorizations

Authorization · string · header · required

Smithery API key as Bearer token

Query Parameters

q · string

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

category · string

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

namespace · string

Filter by the namespace that owns the skill.

slug · string

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

ownerId · string

Filter by the skill owner's organization ID.

verified · boolean

Filter by whether the skill's namespace is verified.

page · integer

Page number (1-indexed).

Required range: 1 <= x <= 9007199254740991

pageSize · integer

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

Required range: 1 <= x <= 100

topK · integer

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.

Required range: 10 <= x <= 500

fields · string

Comma-separated list of fields to include in response

seed · integer

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

Required range: -9007199254740991 <= x <= 9007199254740991

Response

200

application/json

Successful response

skills · object[] · required

Show child attributes

pagination · object · required

Show child attributes