Claude Platform Docs

List Skills

GET/v1/skills

List Skills

Query parameters
limit: optional number

Number of results to return per page.

Maximum value is 100. Defaults to 20.

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

One of the following:
string
"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more
One of the following:
"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"
"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"
Returns
data: array of object{ id, created_at, display_title, 4 more }

List of skills.

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.

display_title: string or null

Display title for the skill.

This is a human-readable label that is not included in the prompt sent to the model.

latest_version: string or null

The latest version identifier for the skill.

This represents the most recent version of the skill that has been created.

source: string

Source of the skill.

This may be one of the following values:

  • "custom": the skill was created by a user
  • "anthropic": the skill was created by Anthropic
type: string

Object type.

For Skills, this is always "skill".

defaultskill
updated_at: string

ISO 8601 timestamp of when the skill was last updated.

has_more: boolean

Whether there are more results available.

If true, there are additional results that can be fetched using the next_page token.

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.

List Skills

curl https://api.anthropic.com/v1/skills \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: skills-2025-10-02' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"
{
  "data": [
    {
      "id": "skill_01JAbcdefghijklmnopqrstuvw",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_title": "My Custom Skill",
      "latest_version": "1759178010641129",
      "source": "custom",
      "type": "type",
      "updated_at": "2024-10-30T23:58:27.427722Z"
    }
  ],
  "has_more": true,
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}
Returns Examples
{
  "data": [
    {
      "id": "skill_01JAbcdefghijklmnopqrstuvw",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_title": "My Custom Skill",
      "latest_version": "1759178010641129",
      "source": "custom",
      "type": "type",
      "updated_at": "2024-10-30T23:58:27.427722Z"
    }
  ],
  "has_more": true,
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}