Repository Public
1---2title: List Skills3url: https://platform.claude.com/docs/en/api/beta/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-beta": optional array of AnthropicBeta`4041 Optional header to specify the beta version(s) you want to use.4243 - `string`4445 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`4647 - `"message-batches-2024-09-24"`4849 - `"prompt-caching-2024-07-31"`5051 - `"computer-use-2024-10-22"`5253 - `"computer-use-2025-01-24"`5455 - `"pdfs-2024-09-25"`5657 - `"token-counting-2024-11-01"`5859 - `"token-efficient-tools-2025-02-19"`6061 - `"output-128k-2025-02-19"`6263 - `"files-api-2025-04-14"`6465 - `"mcp-client-2025-04-04"`6667 - `"mcp-client-2025-11-20"`6869 - `"dev-full-thinking-2025-05-14"`7071 - `"interleaved-thinking-2025-05-14"`7273 - `"code-execution-2025-05-22"`7475 - `"extended-cache-ttl-2025-04-11"`7677 - `"context-1m-2025-08-07"`7879 - `"context-management-2025-06-27"`8081 - `"model-context-window-exceeded-2025-08-26"`8283 - `"skills-2025-10-02"`8485 - `"fast-mode-2026-02-01"`8687 - `"output-300k-2026-03-24"`8889 - `"user-profiles-2026-03-24"`9091 - `"user-profiles-2026-08-18"`9293 - `"user-profiles-2026-09-04"`9495 - `"advisor-tool-2026-03-01"`9697 - `"managed-agents-2026-04-01"`9899 - `"cache-diagnosis-2026-04-07"`100101 - `"dreaming-2026-04-21"`102103 - `"thinking-token-count-2026-05-13"`104105 - `"server-side-fallback-2026-06-01"`106107 - `"server-side-fallback-2026-07-01"`108109 - `"fallback-credit-2026-06-01"`110111 - `"fallback-credit-2026-07-01"`112113 - `"agent-memory-2026-07-22"`114115 - `"mid-conversation-tool-changes-2026-07-01"`116117 - `"compact-2026-01-12"`118119 - `"computer-use-2025-11-24"`120121 - `"mcp-tunnels-2026-06-22"`122123 - `"structured-outputs-2025-11-13"`124125 - `"task-budgets-2026-03-13"`126127 - `"thinking-display-updates-2026-08-18"`128129 - `"ce-user-management-2026-07-13"`130131 - `"mid-conversation-output-config-2026-07-01"`132133 - `"thinking-binding-controls-2026-08-01"`134135 - `"mid-conversation-system-clear-at-2026-08-21"`136137 - `"compact-2026-09-04"`138139- `"anthropic-workspace-id": optional string`140141## Returns142143- `data: array of BetaSkill`144145 List of skills.146147 - `type: "skill"`148149 Object type.150151 For Skills, this is always `"skill"`.152153 default: skill154155 - `id: string`156157 Unique identifier for the skill.158159 The format and length of IDs may change over time.160161 - `created_at: string`162163 ISO 8601 timestamp of when the skill was created.164165 format: date-time166167 - `display_name: string`168169 Human-readable, single-line label for the Skill. Maximum 255 characters.170 Always set: derived from the SKILL.md frontmatter `name` when omitted at171 creation. Not unique.172173 - `latest_version_id: string`174175 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.176177 - `source: BetaSkillSource`178179 Where the Skill comes from.180181 Possible values:182183 * `"custom"`: authored by the platform user; private to their workspace184 * `"anthropic"`: published by Anthropic; shared and read-only185 * `"anthropic_example"`: Anthropic-published sample Skill186 * `"plugin"`: resolved from an installed plugin187188 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`189190 Where the Skill comes from.191192 Possible values:193194 * `"custom"`: authored by the platform user; private to their workspace195 * `"anthropic"`: published by Anthropic; shared and read-only196 * `"anthropic_example"`: Anthropic-published sample Skill197 * `"plugin"`: resolved from an installed plugin198199 - `"custom"`200201 - `"anthropic"`202203 - `"anthropic_example"`204205 - `"plugin"`206207 - `updated_at: string`208209 ISO 8601 timestamp of when the skill was last updated.210211 format: date-time212213- `next_page: string or null`214215 Token for fetching the next page of results.216217 If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.218219## Example220221```bash222curl https://api.anthropic.com/v1/skills \223 -H 'anthropic-version: 2023-06-01' \224 -H "X-Api-Key: $ANTHROPIC_API_KEY"225```226227### Response (200)228229```json230{231 "data": [232 {233 "id": "skill_01JAbcdefghijklmnopqrstuvw",234 "created_at": "2024-10-30T23:58:27.427722Z",235 "display_name": "display_name",236 "latest_version_id": "latest_version_id",237 "source": {238 "type": "custom"239 },240 "type": "skill",241 "updated_at": "2024-10-30T23:58:27.427722Z"242 }243 ],244 "next_page": "next_page"245}246```247