The whole hunk
from line 10, old and new numbered
/
lines
from line 10
1010
1111 Number of results to return per page.
1212
13 Maximum value is 100. Defaults to 20.
13 Ranges from `1` to `1000`. Defaults to `20`.
1414
15 default: 20
15 default: 20, minimum: 1, maximum: 1000
1616
1717- `page: optional string`
1818
from line 123
123123
124124## Returns
125125
126- `data: array of object`
126- `data: array of BetaSkill`
127127
128128 List of skills.
129129
from line 137
137137
138138 ISO 8601 timestamp of when the skill was created.
139139
140 - `display_title: string or null`
140 format: date-time
141141
142 Display title for the skill.
142 - `display_name: string`
143143
144 This is a human-readable label that is not included in the prompt sent to the model.
144 Human-readable, single-line label for the Skill. Maximum 255 characters.
145 Always set: derived from the SKILL.md frontmatter `name` when omitted at
146 creation. Not unique.
145147
146 - `latest_version: string or null`
148 - `latest_version_id: string`
147149
148 The latest version identifier for the skill.
150 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
149151
150 This represents the most recent version of the skill that has been created.
152 - `source: BetaSkillSource`
151153
152 - `source: string`
154 Where the Skill comes from.
153155
154 Source of the skill.
156 Possible values:
155157
156 This may be one of the following values:
158 * `"custom"`: authored by the platform user; private to their workspace
159 * `"anthropic"`: published by Anthropic; shared and read-only
160 * `"anthropic_example"`: Anthropic-published sample Skill
161 * `"plugin"`: resolved from an installed plugin
157162
158 * `"custom"`: the skill was created by a user
159 * `"anthropic"`: the skill was created by Anthropic
163 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`
160164
161 - `type: string`
165 Where the Skill comes from.
162166
167 Possible values:
168
169 * `"custom"`: authored by the platform user; private to their workspace
170 * `"anthropic"`: published by Anthropic; shared and read-only
171 * `"anthropic_example"`: Anthropic-published sample Skill
172 * `"plugin"`: resolved from an installed plugin
173
174 - `"custom"`
175
176 - `"anthropic"`
177
178 - `"anthropic_example"`
179
180 - `"plugin"`
181
182 - `type: "skill"`
183
163184 Object type.
164185
165186 For Skills, this is always `"skill"`.
from line 191
170191
171192 ISO 8601 timestamp of when the skill was last updated.
172193
173- `has_more: boolean`
194 format: date-time
174195
175 Whether there are more results available.
176
177 If `true`, there are additional results that can be fetched using the `next_page` token.
178
179196- `next_page: string or null`
180197
181198 Token for fetching the next page of results.
from line 204
187204```bash
188205curl https://api.anthropic.com/v1/skills \
189206 -H 'anthropic-version: 2023-06-01' \
190 -H 'anthropic-beta: skills-2025-10-02' \
191207 -H "X-Api-Key: $ANTHROPIC_API_KEY"
192208```
193209
from line 215
199215 {
200216 "id": "skill_01JAbcdefghijklmnopqrstuvw",
201217 "created_at": "2024-10-30T23:58:27.427722Z",
202 "display_title": "My Custom Skill",
203 "latest_version": "1759178010641129",
204 "source": "custom",
205 "type": "type",
218 "display_name": "display_name",
219 "latest_version_id": "latest_version_id",
220 "source": {
221 "type": "custom"
222 },
223 "type": "skill",
206224 "updated_at": "2024-10-30T23:58:27.427722Z"
207225 }
208226 ],
209 "has_more": true,
210 "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
227 "next_page": "next_page"
211228}
212229```
213230