SPB Git

Repository Public

list.md 3.2 KB 147 lines markdown

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
Files main
Menu

Theme