List Skills
api/beta/skills/list
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
api/beta/skills/list Changed · +13 / -14 lines
# List Skills ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Skills ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
---- -title: List Skills -url: https://platform.claude.com/docs/en/api/beta/skills/list ---- +# List Skills -## List Skills +**GET** `/v1/skills` -**get** `/v1/skills` - List Skills -### Query Parameters +## Query parameters - `limit: optional number`
Maximum value is 100. Defaults to 20. + default: 20 + - `page: optional string` Pagination token for fetching a specific page of results.
* `"custom"`: only return user-created skills * `"anthropic"`: only return Anthropic-created skills -### Header Parameters +## Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +## Returns -- `data: array of object { id, created_at, display_title, 4 more }` +- `data: array of object` List of skills.
For Skills, this is always `"skill"`. + default: skill + - `updated_at: string` ISO 8601 timestamp of when the skill was last updated.
If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page. -### Example +## Example -```http +```bash curl https://api.anthropic.com/v1/skills \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +### Response (200) ```json {