List Skills

GET /v1/skills

List Skills

Query parameters

• limit: optional number

  Number of results to return per page.

  Ranges from 1 to 1000. Defaults to 20.

  default: 20, minimum: 1, maximum: 1000

• page: optional string

  Pagination token for fetching a specific page of results.

  Pass the value from a previous response's next_page field to get the next page of results.

• source: optional string

  Filter skills by source.

  If provided, only skills from the specified source will be returned:

  • "custom": only return user-created skills
  • "anthropic": only return Anthropic-created skills

Headers

• "anthropic-beta": optional array of AnthropicBeta

  Optional header to specify the beta version(s) you want to use.

  • string

  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more

    • "message-batches-2024-09-24"

    • "prompt-caching-2024-07-31"

    • "computer-use-2024-10-22"

    • "computer-use-2025-01-24"

    • "pdfs-2024-09-25"

    • "token-counting-2024-11-01"

    • "token-efficient-tools-2025-02-19"

    • "output-128k-2025-02-19"

    • "files-api-2025-04-14"

    • "mcp-client-2025-04-04"

    • "mcp-client-2025-11-20"

    • "dev-full-thinking-2025-05-14"

    • "interleaved-thinking-2025-05-14"

    • "code-execution-2025-05-22"

    • "extended-cache-ttl-2025-04-11"

    • "context-1m-2025-08-07"

    • "context-management-2025-06-27"

    • "model-context-window-exceeded-2025-08-26"

    • "skills-2025-10-02"

    • "fast-mode-2026-02-01"

    • "output-300k-2026-03-24"

    • "user-profiles-2026-03-24"

    • "user-profiles-2026-08-18"

    • "user-profiles-2026-09-04"

    • "advisor-tool-2026-03-01"

    • "managed-agents-2026-04-01"

    • "cache-diagnosis-2026-04-07"

    • "dreaming-2026-04-21"

    • "thinking-token-count-2026-05-13"

    • "server-side-fallback-2026-06-01"

    • "server-side-fallback-2026-07-01"

    • "fallback-credit-2026-06-01"

    • "fallback-credit-2026-07-01"

    • "agent-memory-2026-07-22"

    • "mid-conversation-tool-changes-2026-07-01"

    • "compact-2026-01-12"

    • "computer-use-2025-11-24"

    • "mcp-tunnels-2026-06-22"

    • "structured-outputs-2025-11-13"

    • "task-budgets-2026-03-13"

    • "thinking-display-updates-2026-08-18"

    • "ce-user-management-2026-07-13"

    • "mid-conversation-output-config-2026-07-01"

    • "thinking-binding-controls-2026-08-01"

    • "mid-conversation-system-clear-at-2026-08-21"

• "anthropic-workspace-id": optional string

Returns

• data: array of BetaSkill

  List of skills.

  • type: "skill"

    Object type.

    For Skills, this is always "skill".

    default: skill

  • id: string

    Unique identifier for the skill.

    The format and length of IDs may change over time.

  • created_at: string

    ISO 8601 timestamp of when the skill was created.

    format: date-time

  • display_name: string

    Human-readable, single-line label for the Skill. Maximum 255 characters. Always set: derived from the SKILL.md frontmatter name when omitted at creation. Not unique.

  • latest_version_id: string

    ID of the newest Skill Version — what latest references resolve to. Always set: a Skill holds at least one version.

  • source: BetaSkillSource

    Where the Skill comes from.

    Possible values:

    • "custom": authored by the platform user; private to their workspace
    • "anthropic": published by Anthropic; shared and read-only
    • "anthropic_example": Anthropic-published sample Skill
    • "plugin": resolved from an installed plugin

    • type: "custom" or "anthropic" or "anthropic_example" or "plugin"

      Where the Skill comes from.

      Possible values:

      • "custom": authored by the platform user; private to their workspace
      • "anthropic": published by Anthropic; shared and read-only
      • "anthropic_example": Anthropic-published sample Skill
      • "plugin": resolved from an installed plugin

      • "custom"

      • "anthropic"

      • "anthropic_example"

      • "plugin"

  • updated_at: string

    ISO 8601 timestamp of when the skill was last updated.

    format: date-time

• next_page: string or null

  Token for fetching the next page of results.

  If null, there are no more results available. Pass this value to the page parameter in the next request to get the next page.

Example

curl https://api.anthropic.com/v1/skills \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response (200)

{
  "data": [
    {
      "id": "skill_01JAbcdefghijklmnopqrstuvw",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_name": "display_name",
      "latest_version_id": "latest_version_id",
      "source": {
        "type": "custom"
      },
      "type": "skill",
      "updated_at": "2024-10-30T23:58:27.427722Z"
    }
  ],
  "next_page": "next_page"
}