Source: https://docs.claude.com/en/api/skills/list-skills

Agent Skills are now available! Learn more about extending Claude's capabilities with Agent Skills .

Claude Docs home page

English

Search...

Ctrl K

Search...

Navigation

Skill Management

List Skills

Home Developer Guide API Reference Model Context Protocol (MCP) Resources Release Notes

cURL

cURL

Copy

curl "https://api.anthropic.com/v1/skills" \
     -H "x-api-key: $ANTHROPIC_API_KEY" \
     -H "anthropic-version: 2023-06-01" \
     -H "anthropic-beta: skills-2025-10-02"

200

4XX

Copy

{
  "data": [\
    {\
      "created_at": "2024-10-30T23:58:27.427722Z",\
      "display_title": "My Custom Skill",\
      "id": "skill_01JAbcdefghijklmnopqrstuvw",\
      "latest_version": "1759178010641129",\
      "source": "custom",\
      "type": "skill",\
      "updated_at": "2024-10-30T23:58:27.427722Z"\
    }\
  ],
  "has_more": true,
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

GET

/

v1

/

skills

cURL

cURL

Copy

curl "https://api.anthropic.com/v1/skills" \
     -H "x-api-key: $ANTHROPIC_API_KEY" \
     -H "anthropic-version: 2023-06-01" \
     -H "anthropic-beta: skills-2025-10-02"

200

4XX

Copy

{
  "data": [\
    {\
      "created_at": "2024-10-30T23:58:27.427722Z",\
      "display_title": "My Custom Skill",\
      "id": "skill_01JAbcdefghijklmnopqrstuvw",\
      "latest_version": "1759178010641129",\
      "source": "custom",\
      "type": "skill",\
      "updated_at": "2024-10-30T23:58:27.427722Z"\
    }\
  ],
  "has_more": true,
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

Headers

​

anthropic-beta

string[]

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

To use multiple betas, use a comma separated list like beta1,beta2 or specify the header multiple times for each beta.

​

anthropic-version

string

required

The version of the Claude API you want to use.

Read more about versioning and our version history here .

​

x-api-key

string

required

Your unique API key for authentication.

This key is required in the header of all API requests, to authenticate your account and access Anthropic's services. Get your API key through the Console . Each key is scoped to a Workspace.

Query Parameters

​

page

string | null

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.

​

limit

integer

default:20

Number of results to return per page.

Maximum value is 100. Defaults to 20.

​

source

string | null

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

Response

200

application/json

Successful Response

​

data

Skill · object[]

required

List of skills.

Show child attributes

​

has_more

boolean

required

Whether there are more results available.

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

​

next_page

string | null

required

Token for fetching the next page of results.

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

Examples:

"page_MjAyNS0wNS0xNFQwMDowMDowMFo="

null

Was this page helpful?

YesNo

Create Skill Get Skill

Assistant

Responses are generated using AI and may contain mistakes.