### Headers ### Headers ### Headers ### Headers #### Headers #### Headers #### Headers #### Headers
The whole hunk
from line 1, old and new numbered
/
lines
from line 1
1---
2title: Skills
3url: https://platform.claude.com/docs/en/api/skills
4---
5
16# Skills
27
38## Create Skill
from line 11
611
712Create Skill
813
14### Headers
15
16- `"anthropic-workspace-id": optional string`
17
918### Body parameters (form-data)
1019
1120- `files: array of string`
from line 33
2433
2534- `Skill object`
2635
36 - `type: "skill"`
37
38 Object type.
39
40 For Skills, this is always `"skill"`.
41
42 default: skill
43
2744 - `id: string`
2845
2946 Unique identifier for the skill.
from line 93
7693
7794 - `"plugin"`
7895
79 - `type: "skill"`
80
81 Object type.
82
83 For Skills, this is always `"skill"`.
84
85 default: skill
86
8796 - `updated_at: string`
8897
8998 ISO 8601 timestamp of when the skill was last updated.
from line 156
147156 * `"custom"`: only return user-created skills
148157 * `"anthropic"`: only return Anthropic-created skills
149158
159### Headers
160
161- `"anthropic-workspace-id": optional string`
162
150163### Returns
151164
152165- `data: array of Skill`
from line 166
153166
154167 List of skills.
155168
169 - `type: "skill"`
170
171 Object type.
172
173 For Skills, this is always `"skill"`.
174
175 default: skill
176
156177 - `id: string`
157178
158179 Unique identifier for the skill.
from line 226
205226
206227 - `"plugin"`
207228
208 - `type: "skill"`
209
210 Object type.
211
212 For Skills, this is always `"skill"`.
213
214 default: skill
215
216229 - `updated_at: string`
217230
218231 ISO 8601 timestamp of when the skill was last updated.
from line 281
268281
269282 The format and length of IDs may change over time.
270283
284### Headers
285
286- `"anthropic-workspace-id": optional string`
287
271288### Returns
272289
273290- `Skill object`
274291
292 - `type: "skill"`
293
294 Object type.
295
296 For Skills, this is always `"skill"`.
297
298 default: skill
299
275300 - `id: string`
276301
277302 Unique identifier for the skill.
from line 349
324349
325350 - `"plugin"`
326351
327 - `type: "skill"`
328
329 Object type.
330
331 For Skills, this is always `"skill"`.
332
333 default: skill
334
335352 - `updated_at: string`
336353
337354 ISO 8601 timestamp of when the skill was last updated.
from line 393
376393
377394 The format and length of IDs may change over time.
378395
396### Headers
397
398- `"anthropic-workspace-id": optional string`
399
379400### Returns
380401
381402- `DeletedSkill object`
382403
383 - `id: string`
384
385 Unique identifier for the skill.
386
387 The format and length of IDs may change over time.
388
389404 - `type: "skill_deleted"`
390405
391406 Deleted object type.
from line 409
394409
395410 default: skill_deleted
396411
412 - `id: string`
413
414 Unique identifier for the skill.
415
416 The format and length of IDs may change over time.
417
397418### Example
398419
399420```bash
from line 439
418439
419440- `DeletedSkill object`
420441
421 - `id: string`
422
423 Unique identifier for the skill.
424
425 The format and length of IDs may change over time.
426
427442 - `type: "skill_deleted"`
428443
429444 Deleted object type.
from line 447
432447
433448 default: skill_deleted
434449
450 - `id: string`
451
452 Unique identifier for the skill.
453
454 The format and length of IDs may change over time.
455
435456### Skill
436457
437458- `Skill object`
438459
460 - `type: "skill"`
461
462 Object type.
463
464 For Skills, this is always `"skill"`.
465
466 default: skill
467
439468 - `id: string`
440469
441470 Unique identifier for the skill.
from line 517
488517
489518 - `"plugin"`
490519
491 - `type: "skill"`
492
493 Object type.
494
495 For Skills, this is always `"skill"`.
496
497 default: skill
498
499520 - `updated_at: string`
500521
501522 ISO 8601 timestamp of when the skill was last updated.
from line 562
541562
542563 The format and length of IDs may change over time.
543564
565#### Headers
566
567- `"anthropic-workspace-id": optional string`
568
544569#### Body parameters (form-data)
545570
546571- `files: array of string`
from line 578
553578
554579- `SkillVersion object`
555580
581 - `type: "skill_version"`
582
583 Object type.
584
585 For Skill Versions, this is always `"skill_version"`.
586
587 default: skill_version
588
556589 - `id: string`
557590
558591 Unique identifier for this Skill Version. The id addresses the version in
from line 616
583616
584617 The format and length of IDs may change over time.
585618
586 - `type: "skill_version"`
587
588 Object type.
589
590 For Skill Versions, this is always `"skill_version"`.
591
592 default: skill_version
593
594619#### Example
595620
596621```bash
from line 667
642667
643668 Optionally set to the `next_page` token from the previous response.
644669
670#### Headers
671
672- `"anthropic-workspace-id": optional string`
673
645674#### Returns
646675
647676- `data: array of SkillVersion`
from line 677
648677
649678 List of skills.
650679
680 - `type: "skill_version"`
681
682 Object type.
683
684 For Skill Versions, this is always `"skill_version"`.
685
686 default: skill_version
687
651688 - `id: string`
652689
653690 Unique identifier for this Skill Version. The id addresses the version in
from line 715
678715
679716 The format and length of IDs may change over time.
680717
681 - `type: "skill_version"`
682
683 Object type.
684
685 For Skill Versions, this is always `"skill_version"`.
686
687 default: skill_version
688
689718- `next_page: string or null`
690719
691720 Token for fetching the next page of results.
from line 767
738767
739768 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").
740769
770#### Headers
771
772- `"anthropic-workspace-id": optional string`
773
741774#### Returns
742775
743776- `SkillVersion object`
744777
778 - `type: "skill_version"`
779
780 Object type.
781
782 For Skill Versions, this is always `"skill_version"`.
783
784 default: skill_version
785
745786 - `id: string`
746787
747788 Unique identifier for this Skill Version. The id addresses the version in
from line 813
772813
773814 The format and length of IDs may change over time.
774815
775 - `type: "skill_version"`
776
777 Object type.
778
779 For Skill Versions, this is always `"skill_version"`.
780
781 default: skill_version
782
783816#### Example
784817
785818```bash
from line 854
821854
822855 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").
823856
857#### Headers
858
859- `"anthropic-workspace-id": optional string`
860
824861#### Returns
825862
826863- `DeletedSkillVersion object`
827864
828 - `id: string`
829
830 Unique identifier for this Skill Version. The id addresses the version in
831 paths and pins it in references.
832
833865 - `type: "skill_version_deleted"`
834866
835867 Deleted object type.
from line 869
837869 For Skill Versions, this is always `"skill_version_deleted"`.
838870
839871 default: skill_version_deleted
872
873 - `id: string`
874
875 Unique identifier for this Skill Version. The id addresses the version in
876 paths and pins it in references.
840877
841878#### Example
842879