GET
/
v1
/
skills
cURL
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"
{
  "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

Successful Response

​
data
Skill · object[]
required

List of skills.

​
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