GET
/
v1
/
skills
/
{skill_id}
cURL
curl "https://api.anthropic.com/v1/skills/skill_01AbCdEfGhIjKlMnOpQrStUv" \
     -H "x-api-key: $ANTHROPIC_API_KEY" \
     -H "anthropic-version: 2023-06-01" \
     -H "anthropic-beta: skills-2025-10-02"
{
  "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"
}

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.

Path Parameters

​
skill_id
string
required

Unique identifier for the skill.

The format and length of IDs may change over time.

Response

Successful Response

​
created_at
string
required

ISO 8601 timestamp of when the skill was created.

Examples:

"2024-10-30T23:58:27.427722Z"

​
display_title
string | null
required

Display title for the skill.

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

Examples:

"My Custom Skill"

​
id
string
required

Unique identifier for the skill.

The format and length of IDs may change over time.

Examples:

"skill_01JAbcdefghijklmnopqrstuvw"

​
latest_version
string | null
required

The latest version identifier for the skill.

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

Examples:

"1759178010641129"

​
source
string
required

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
Examples:

"custom"

​
type
string
default:skill
required

Object type.

For Skills, this is always "skill".

​
updated_at
string
required

ISO 8601 timestamp of when the skill was last updated.

Examples:

"2024-10-30T23:58:27.427722Z"