Repository Public
1---2title: Get Skill3url: https://platform.claude.com/docs/en/api/skills/retrieve4---56# Get Skill78**GET** `/v1/skills/{skill_id}`910Get Skill1112## Path parameters1314- `skill_id: string`1516 Unique identifier for the skill.1718 The format and length of IDs may change over time.1920## Headers2122- `"anthropic-workspace-id": optional string`2324## Returns2526- `Skill object`2728 - `type: "skill"`2930 Object type.3132 For Skills, this is always `"skill"`.3334 default: skill3536 - `id: string`3738 Unique identifier for the skill.3940 The format and length of IDs may change over time.4142 - `created_at: string`4344 ISO 8601 timestamp of when the skill was created.4546 format: date-time4748 - `display_name: string`4950 Human-readable, single-line label for the Skill. Maximum 255 characters.51 Always set: derived from the SKILL.md frontmatter `name` when omitted at52 creation. Not unique.5354 - `latest_version_id: string`5556 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.5758 - `source: SkillSource`5960 Where the Skill comes from.6162 Possible values:6364 * `"custom"`: authored by the platform user; private to their workspace65 * `"anthropic"`: published by Anthropic; shared and read-only66 * `"anthropic_example"`: Anthropic-published sample Skill67 * `"plugin"`: resolved from an installed plugin6869 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`7071 Where the Skill comes from.7273 Possible values:7475 * `"custom"`: authored by the platform user; private to their workspace76 * `"anthropic"`: published by Anthropic; shared and read-only77 * `"anthropic_example"`: Anthropic-published sample Skill78 * `"plugin"`: resolved from an installed plugin7980 - `"custom"`8182 - `"anthropic"`8384 - `"anthropic_example"`8586 - `"plugin"`8788 - `updated_at: string`8990 ISO 8601 timestamp of when the skill was last updated.9192 format: date-time9394## Example9596```bash97curl https://api.anthropic.com/v1/skills/$SKILL_ID \98 -H 'anthropic-version: 2023-06-01' \99 -H "X-Api-Key: $ANTHROPIC_API_KEY"100```101102### Response (200)103104```json105{106 "id": "skill_01JAbcdefghijklmnopqrstuvw",107 "created_at": "2024-10-30T23:58:27.427722Z",108 "display_name": "display_name",109 "latest_version_id": "latest_version_id",110 "source": {111 "type": "custom"112 },113 "type": "skill",114 "updated_at": "2024-10-30T23:58:27.427722Z"115}116```117