> ## Documentation Index
> Fetch the complete documentation index at: https://smithery.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml get /skills
openapi: 3.1.0
info:
  title: Smithery Platform API
  description: >-
    API for the Smithery platform — discover, deploy, and manage MCP (Model
    Context Protocol) servers. Provides endpoints for browsing the server
    registry, managing deployments, creating scoped access tokens, and
    connecting to MCP servers.
  version: 1.0.0
servers:
  - url: https://api.smithery.ai
security:
  - bearerAuth: []
tags:
  - name: servers
    description: >-
      Browse the MCP server registry, manage server configuration, and handle
      deployments
  - name: skills
    description: Discover and search reusable prompt-based skills for MCP servers
  - name: tools
    description: Search for MCP tools across all registered servers
paths:
  /skills:
    get:
      tags:
        - skills
      summary: List or search skills
      description: >-
        Search and browse reusable prompt-based skills. Supports full-text and
        semantic search via the `q` parameter, and filtering by category,
        namespace, or slug.
      operationId: getSkills
      parameters:
        - in: query
          name: q
          schema:
            type: string
          description: >-
            Search query for full-text and semantic search across skill names
            and descriptions.
        - in: query
          name: category
          schema:
            type: string
          description: Filter by skill category (e.g. 'code', 'data', 'web').
        - in: query
          name: namespace
          schema:
            type: string
          description: Filter by the namespace that owns the skill.
        - in: query
          name: slug
          schema:
            type: string
          description: >-
            Filter by exact skill slug within a namespace. Deprecated: use GET
            /skills/:namespace/:slug instead.
        - in: query
          name: ownerId
          schema:
            type: string
          description: Filter by the skill owner's organization ID.
        - in: query
          name: verified
          schema:
            type: boolean
          description: Filter by whether the skill's namespace is verified.
        - in: query
          name: page
          schema:
            type: integer
            minimum: 1
            maximum: 9007199254740991
          description: Page number (1-indexed).
        - in: query
          name: pageSize
          schema:
            type: integer
            minimum: 1
            maximum: 100
          description: Number of results per page (default 20, max 100).
        - in: query
          name: topK
          schema:
            type: integer
            minimum: 10
            maximum: 500
          description: >-
            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.
        - in: query
          name: fields
          schema:
            type: string
          description: Comma-separated list of fields to include in response
        - in: query
          name: seed
          schema:
            type: integer
            minimum: -9007199254740991
            maximum: 9007199254740991
          description: >-
            Random seed for deterministic pagination. When provided, results use
            a stable sort order that is consistent across pages for the same
            seed value.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SkillsListResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SkillsListError'
      x-codeSamples:
        - lang: JavaScript
          source: |-
            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);
            }
components:
  schemas:
    SkillsListResponse:
      type: object
      properties:
        skills:
          type: array
          items:
            $ref: '#/components/schemas/SkillSummary'
        pagination:
          type: object
          properties:
            currentPage:
              type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
              description: Current page number (1-indexed).
            pageSize:
              type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
              description: Number of results per page.
            totalPages:
              type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
              description: Total number of pages available.
            totalCount:
              type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
              description: Total number of matching skills.
          required:
            - currentPage
            - pageSize
            - totalPages
            - totalCount
          additionalProperties: false
      required:
        - skills
        - pagination
      additionalProperties: false
    SkillsListError:
      type: object
      properties:
        error:
          type: string
      required:
        - error
      additionalProperties: false
    SkillSummary:
      type: object
      properties:
        id:
          type: string
        namespace:
          type: string
          description: Namespace that owns this skill.
        slug:
          type: string
          description: URL-friendly short name within the namespace.
        displayName:
          type: string
        description:
          type: string
        prompt:
          anyOf:
            - type: string
            - type: 'null'
          description: The prompt template for this skill, or null if not publicly visible.
        qualityScore:
          type: number
          description: Computed quality score from 0 to 1.
        externalStars:
          description: GitHub star count of the source repository, if applicable.
          type: number
        externalForks:
          description: GitHub fork count of the source repository, if applicable.
          type: number
        totalActivations:
          description: Total number of times this skill has been activated.
          type: number
        uniqueUsers:
          description: Number of distinct users who have activated this skill.
          type: number
        categories:
          description: List of categories this skill belongs to.
          type: array
          items:
            type: string
        servers:
          description: Qualified names of MCP servers this skill depends on.
          type: array
          items:
            type: string
        gitUrl:
          description: URL to the skill's source repository.
          anyOf:
            - type: string
            - type: 'null'
        verified:
          type: boolean
          description: Whether this skill's namespace is verified.
        listed:
          type: boolean
          description: Whether this skill is publicly listed in the registry.
        createdAt:
          type: string
          description: ISO 8601 timestamp of when the skill was created.
      required:
        - id
        - namespace
        - slug
        - displayName
        - description
        - prompt
        - qualityScore
        - verified
        - listed
        - createdAt
      additionalProperties: false
      id: SkillSummary
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Smithery API key as Bearer token

````