---
title: "List public registry skills with search and filters"
method: GET
path: "/v1/skills"
tags: ["public"]
---

# List public registry skills with search and filters

`GET /v1/skills`

## Request

- Base URL: `https://api.runx.ai`
- URL: `https://api.runx.ai/v1/skills`
- Auth: none declared

## Query parameters

- `q` string
- `owner` string
- `tag` string
- `kind` string
- `category` string
- `profile_mode` string
- `featured` string
- `include` string
- `trust_tier` string
- `ids` string
- `connector` string
- `sort` string
- `limit` string
- `cursor` string
- `count` string
- `facets` string

## Response `200`

Public registry listing.

- PublicSkillsResponse
  - `query` PublicSkillsQuery, required
    - `q` string, required
    - `owner` string
    - `tag` string
    - `kind` 'skill' | 'graph'
    - `category` string
    - `profile_mode` 'profiled' | 'portable'
    - `sort` 'recommended' | 'newest' | 'a-z' | 'most-installed' | 'relevance', required
    - `include` 'unverified'
    - `trust_tier` 'first_party' | 'verified' | 'community'
    - `featured` boolean
    - `ids` string[]
    - `connector` string
    - `limit` number, required
    - `cursor` string
  - `skills` PublicSkillSummary[], required
    - `skill_id` string, required
    - `owner` string, required
    - `publisher` PublicPublisher, required
      - `id` string, required
      - `slug` string, required
      - `handle` string, required
      - `display_name` string, required
      - `kind` 'org' | 'user' | 'team', required
      - `verified` boolean, required
      - `image` PublicMark
        - `sha256` string, required
        - `url` string, required
      - `url` string, required
    - `trust_tier` 'first_party' | 'verified' | 'community', required
    - `maturity` 'alpha' | 'beta' | 'stable', required
    - `name` string, required
    - `title` string, required
    - `summary` string
    - `mark` union, required
      - PublicDeclaredMark
        - `sha256` string, required
        - `url` string, required
        - `source` 'own' | 'category', required
      - PublicBoundConnectorMark
        - `sha256` string, required
        - `url` string, required
        - `source` 'connector', required
        - `connector_ref` string, required
    - `discoverable` boolean, required
    - `relationships` PublicSkillRelationship[]
      - `kind` 'evidence_source' | 'handoff' | 'ecosystem', required
      - `id` string, required
      - `label` string, required
      - `reference` string
    - `connectors` PublicSkillConnector[], required
      - `ref` string, required
      - `version` string, required
      - `name` string, required
      - `runtime_capability` boolean, required
      - `trust_tier` 'first_party' | 'verified' | 'community'
      - `mark` PublicDeclaredMark, required
        - `sha256` string, required
        - `url` string, required
        - `source` 'own' | 'category', required
    - `description` string
    - `catalog_kind` 'skill' | 'graph', required
    - `version` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `profile_mode` 'profiled' | 'portable', required
    - `runner_names` string[], required
    - `paid_listing` PaidSkillListingContract
      - `skill_id` string, required
      - `version` string, required
      - `skill_digest` string, required
      - `profile_digest` string, required
      - `package_digest` string, required
      - `vendor_ref` object, required
        - `schema` string
        - `uri` string, required
        - `provider` string
        - `locator` string
        - `label` string
        - `observed_at` string
        - `proof_kind` string
        - `type` 'principal', required
      - `offers` object, required
    - `required_scopes` string[], required
    - `tags` string[], required
    - `category` string, required
    - `category_label` string, required
    - `install_count` number, required
    - `verified_run_count` number, required
    - `last_verified_run_at` string
    - `page_url` string, required
    - `install_command` CopyableCommand, required
      - `shell` 'posix', required
      - `argv` string[], required
      - `copy_text` string, required
    - `run_command` CopyableCommand, required
      - `shell` 'posix', required
      - `argv` string[], required
      - `copy_text` string, required
    - `catalog_visibility` 'public' | 'internal'
  - `has_more` boolean, required
  - `next_cursor` string
  - `total` number
  - `catalog_total` number
  - `connector` object
    - `ref` string, required
    - `name` string, required
  - `facets` object
    - `owners` FacetEntry[], required
      - `value` string, required
      - `count` number, required
    - `tags` FacetEntry[], required
      - `value` string, required
      - `count` number, required
    - `kinds` FacetEntry[], required
      - `value` string, required
      - `count` number, required
    - `categories` CategoryFacetEntry[], required
      - `value` string, required
      - `count` number, required
      - `label` string, required
      - `surface` 'builder'
    - `profile_modes` FacetEntry[], required
      - `value` string, required
      - `count` number, required
  - `status` 'success', required

---

[API](https://skmtc.dev/runx/apis/runx-hosted-api.md) · [All operations](https://skmtc.dev/runx/apis/runx-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runx/apis/runx-hosted-api/revisions/6c940d8edacc?raw)