Repository Public
1---2title: List Skills3url: https://platform.claude.com/docs/en/api/skills/list4---56# List Skills78**GET** `/v1/skills`910List Skills1112## Query parameters1314- `limit: optional number`1516 Number of results to return per page.1718 Ranges from `1` to `1000`. Defaults to `20`.1920 default: 20, minimum: 1, maximum: 10002122- `page: optional string`2324 Pagination token for fetching a specific page of results.2526 Pass the value from a previous response's `next_page` field to get the next page of results.2728- `source: optional string`2930 Filter skills by source.3132 If provided, only skills from the specified source will be returned:3334 * `"custom"`: only return user-created skills35 * `"anthropic"`: only return Anthropic-created skills3637## Headers3839- `"anthropic-workspace-id": optional string`4041## Returns4243- `data: array of Skill`4445 List of skills.4647 - `type: "skill"`4849 Object type.5051 For Skills, this is always `"skill"`.5253 default: skill5455 - `id: string`5657 Unique identifier for the skill.5859 The format and length of IDs may change over time.6061 - `created_at: string`6263 ISO 8601 timestamp of when the skill was created.6465 format: date-time6667 - `display_name: string`6869 Human-readable, single-line label for the Skill. Maximum 255 characters.70 Always set: derived from the SKILL.md frontmatter `name` when omitted at71 creation. Not unique.7273 - `latest_version_id: string`7475 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.7677 - `source: SkillSource`7879 Where the Skill comes from.8081 Possible values:8283 * `"custom"`: authored by the platform user; private to their workspace84 * `"anthropic"`: published by Anthropic; shared and read-only85 * `"anthropic_example"`: Anthropic-published sample Skill86 * `"plugin"`: resolved from an installed plugin8788 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`8990 Where the Skill comes from.9192 Possible values:9394 * `"custom"`: authored by the platform user; private to their workspace95 * `"anthropic"`: published by Anthropic; shared and read-only96 * `"anthropic_example"`: Anthropic-published sample Skill97 * `"plugin"`: resolved from an installed plugin9899 - `"custom"`100101 - `"anthropic"`102103 - `"anthropic_example"`104105 - `"plugin"`106107 - `updated_at: string`108109 ISO 8601 timestamp of when the skill was last updated.110111 format: date-time112113- `next_page: string or null`114115 Token for fetching the next page of results.116117 If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.118119## Example120121```bash122curl https://api.anthropic.com/v1/skills \123 -H 'anthropic-version: 2023-06-01' \124 -H "X-Api-Key: $ANTHROPIC_API_KEY"125```126127### Response (200)128129```json130{131 "data": [132 {133 "id": "skill_01JAbcdefghijklmnopqrstuvw",134 "created_at": "2024-10-30T23:58:27.427722Z",135 "display_name": "display_name",136 "latest_version_id": "latest_version_id",137 "source": {138 "type": "custom"139 },140 "type": "skill",141 "updated_at": "2024-10-30T23:58:27.427722Z"142 }143 ],144 "next_page": "next_page"145}146```147