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/beta/skills
4---
5
16# Skills
27
38## Create Skill
from line 19
1419
1520 - `string`
1621
17 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
1823
1924 - `"message-batches-2024-09-24"`
2025
from line 67
6267
6368 - `"user-profiles-2026-08-18"`
6469
70 - `"user-profiles-2026-09-04"`
71
6572 - `"advisor-tool-2026-03-01"`
6673
6774 - `"managed-agents-2026-04-01"`
from line 111
104111
105112 - `"mid-conversation-system-clear-at-2026-08-21"`
106113
114- `"anthropic-workspace-id": optional string`
115
107116### Body parameters (form-data)
108117
109118- `files: array of string`
from line 131
122131
123132- `BetaSkill object`
124133
134 - `type: "skill"`
135
136 Object type.
137
138 For Skills, this is always `"skill"`.
139
140 default: skill
141
125142 - `id: string`
126143
127144 Unique identifier for the skill.
from line 191
174191
175192 - `"plugin"`
176193
177 - `type: "skill"`
178
179 Object type.
180
181 For Skills, this is always `"skill"`.
182
183 default: skill
184
185194 - `updated_at: string`
186195
187196 ISO 8601 timestamp of when the skill was last updated.
from line 262
253262
254263 - `string`
255264
256 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
265 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
257266
258267 - `"message-batches-2024-09-24"`
259268
from line 310
301310
302311 - `"user-profiles-2026-08-18"`
303312
313 - `"user-profiles-2026-09-04"`
314
304315 - `"advisor-tool-2026-03-01"`
305316
306317 - `"managed-agents-2026-04-01"`
from line 354
343354
344355 - `"mid-conversation-system-clear-at-2026-08-21"`
345356
357- `"anthropic-workspace-id": optional string`
358
346359### Returns
347360
348361- `data: array of BetaSkill`
from line 362
349362
350363 List of skills.
351364
365 - `type: "skill"`
366
367 Object type.
368
369 For Skills, this is always `"skill"`.
370
371 default: skill
372
352373 - `id: string`
353374
354375 Unique identifier for the skill.
from line 422
401422
402423 - `"plugin"`
403424
404 - `type: "skill"`
405
406 Object type.
407
408 For Skills, this is always `"skill"`.
409
410 default: skill
411
412425 - `updated_at: string`
413426
414427 ISO 8601 timestamp of when the skill was last updated.
from line 485
472485
473486 - `string`
474487
475 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
488 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
476489
477490 - `"message-batches-2024-09-24"`
478491
from line 533
520533
521534 - `"user-profiles-2026-08-18"`
522535
536 - `"user-profiles-2026-09-04"`
537
523538 - `"advisor-tool-2026-03-01"`
524539
525540 - `"managed-agents-2026-04-01"`
from line 577
562577
563578 - `"mid-conversation-system-clear-at-2026-08-21"`
564579
580- `"anthropic-workspace-id": optional string`
581
565582### Returns
566583
567584- `BetaSkill object`
568585
586 - `type: "skill"`
587
588 Object type.
589
590 For Skills, this is always `"skill"`.
591
592 default: skill
593
569594 - `id: string`
570595
571596 Unique identifier for the skill.
from line 643
618643
619644 - `"plugin"`
620645
621 - `type: "skill"`
622
623 Object type.
624
625 For Skills, this is always `"skill"`.
626
627 default: skill
628
629646 - `updated_at: string`
630647
631648 ISO 8601 timestamp of when the skill was last updated.
from line 695
678695
679696 - `string`
680697
681 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
698 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
682699
683700 - `"message-batches-2024-09-24"`
684701
from line 743
726743
727744 - `"user-profiles-2026-08-18"`
728745
746 - `"user-profiles-2026-09-04"`
747
729748 - `"advisor-tool-2026-03-01"`
730749
731750 - `"managed-agents-2026-04-01"`
from line 787
768787
769788 - `"mid-conversation-system-clear-at-2026-08-21"`
770789
790- `"anthropic-workspace-id": optional string`
791
771792### Returns
772793
773794- `BetaDeletedSkill object`
774795
775 - `id: string`
776
777 Unique identifier for the skill.
778
779 The format and length of IDs may change over time.
780
781796 - `type: "skill_deleted"`
782797
783798 Deleted object type.
from line 801
786801
787802 default: skill_deleted
788803
804 - `id: string`
805
806 Unique identifier for the skill.
807
808 The format and length of IDs may change over time.
809
789810### Example
790811
791812```bash
from line 831
810831
811832- `BetaDeletedSkill object`
812833
813 - `id: string`
814
815 Unique identifier for the skill.
816
817 The format and length of IDs may change over time.
818
819834 - `type: "skill_deleted"`
820835
821836 Deleted object type.
from line 839
824839
825840 default: skill_deleted
826841
842 - `id: string`
843
844 Unique identifier for the skill.
845
846 The format and length of IDs may change over time.
847
827848### Beta Skill
828849
829850- `BetaSkill object`
830851
852 - `type: "skill"`
853
854 Object type.
855
856 For Skills, this is always `"skill"`.
857
858 default: skill
859
831860 - `id: string`
832861
833862 Unique identifier for the skill.
from line 909
880909
881910 - `"plugin"`
882911
883 - `type: "skill"`
884
885 Object type.
886
887 For Skills, this is always `"skill"`.
888
889 default: skill
890
891912 - `updated_at: string`
892913
893914 ISO 8601 timestamp of when the skill was last updated.
from line 962
941962
942963 - `string`
943964
944 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
965 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
945966
946967 - `"message-batches-2024-09-24"`
947968
from line 1010
9891010
9901011 - `"user-profiles-2026-08-18"`
9911012
1013 - `"user-profiles-2026-09-04"`
1014
9921015 - `"advisor-tool-2026-03-01"`
9931016
9941017 - `"managed-agents-2026-04-01"`
from line 1054
10311054
10321055 - `"mid-conversation-system-clear-at-2026-08-21"`
10331056
1057- `"anthropic-workspace-id": optional string`
1058
10341059#### Body parameters (form-data)
10351060
10361061- `files: array of string`
from line 1068
10431068
10441069- `BetaSkillVersion object`
10451070
1071 - `type: "skill_version"`
1072
1073 Object type.
1074
1075 For Skill Versions, this is always `"skill_version"`.
1076
1077 default: skill_version
1078
10461079 - `id: string`
10471080
10481081 Unique identifier for this Skill Version. The id addresses the version in
from line 1106
10731106
10741107 The format and length of IDs may change over time.
10751108
1076 - `type: "skill_version"`
1077
1078 Object type.
1079
1080 For Skill Versions, this is always `"skill_version"`.
1081
1082 default: skill_version
1083
10841109#### Example
10851110
10861111```bash
from line 1165
11401165
11411166 - `string`
11421167
1143 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1168 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
11441169
11451170 - `"message-batches-2024-09-24"`
11461171
from line 1213
11881213
11891214 - `"user-profiles-2026-08-18"`
11901215
1216 - `"user-profiles-2026-09-04"`
1217
11911218 - `"advisor-tool-2026-03-01"`
11921219
11931220 - `"managed-agents-2026-04-01"`
from line 1257
12301257
12311258 - `"mid-conversation-system-clear-at-2026-08-21"`
12321259
1260- `"anthropic-workspace-id": optional string`
1261
12331262#### Returns
12341263
12351264- `data: array of BetaSkillVersion`
from line 1265
12361265
12371266 List of skills.
12381267
1268 - `type: "skill_version"`
1269
1270 Object type.
1271
1272 For Skill Versions, this is always `"skill_version"`.
1273
1274 default: skill_version
1275
12391276 - `id: string`
12401277
12411278 Unique identifier for this Skill Version. The id addresses the version in
from line 1303
12661303
12671304 The format and length of IDs may change over time.
12681305
1269 - `type: "skill_version"`
1270
1271 Object type.
1272
1273 For Skill Versions, this is always `"skill_version"`.
1274
1275 default: skill_version
1276
12771306- `next_page: string or null`
12781307
12791308 Token for fetching the next page of results.
from line 1363
13341363
13351364 - `string`
13361365
1337 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1366 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
13381367
13391368 - `"message-batches-2024-09-24"`
13401369
from line 1411
13821411
13831412 - `"user-profiles-2026-08-18"`
13841413
1414 - `"user-profiles-2026-09-04"`
1415
13851416 - `"advisor-tool-2026-03-01"`
13861417
13871418 - `"managed-agents-2026-04-01"`
from line 1455
14241455
14251456 - `"mid-conversation-system-clear-at-2026-08-21"`
14261457
1458- `"anthropic-workspace-id": optional string`
1459
14271460#### Example
14281461
14291462```bash
from line 1493
14601493
14611494 - `string`
14621495
1463 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1496 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
14641497
14651498 - `"message-batches-2024-09-24"`
14661499
from line 1541
15081541
15091542 - `"user-profiles-2026-08-18"`
15101543
1544 - `"user-profiles-2026-09-04"`
1545
15111546 - `"advisor-tool-2026-03-01"`
15121547
15131548 - `"managed-agents-2026-04-01"`
from line 1585
15501585
15511586 - `"mid-conversation-system-clear-at-2026-08-21"`
15521587
1588- `"anthropic-workspace-id": optional string`
1589
15531590#### Returns
15541591
15551592- `BetaSkillVersion object`
15561593
1594 - `type: "skill_version"`
1595
1596 Object type.
1597
1598 For Skill Versions, this is always `"skill_version"`.
1599
1600 default: skill_version
1601
15571602 - `id: string`
15581603
15591604 Unique identifier for this Skill Version. The id addresses the version in
from line 1629
15841629
15851630 The format and length of IDs may change over time.
15861631
1587 - `type: "skill_version"`
1588
1589 Object type.
1590
1591 For Skill Versions, this is always `"skill_version"`.
1592
1593 default: skill_version
1594
15951632#### Example
15961633
15971634```bash
from line 1678
16411678
16421679 - `string`
16431680
1644 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1681 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
16451682
16461683 - `"message-batches-2024-09-24"`
16471684
from line 1726
16891726
16901727 - `"user-profiles-2026-08-18"`
16911728
1729 - `"user-profiles-2026-09-04"`
1730
16921731 - `"advisor-tool-2026-03-01"`
16931732
16941733 - `"managed-agents-2026-04-01"`
from line 1770
17311770
17321771 - `"mid-conversation-system-clear-at-2026-08-21"`
17331772
1773- `"anthropic-workspace-id": optional string`
1774
17341775#### Returns
17351776
17361777- `BetaDeletedSkillVersion object`
17371778
1738 - `id: string`
1739
1740 Unique identifier for this Skill Version. The id addresses the version in
1741 paths and pins it in references.
1742
17431779 - `type: "skill_version_deleted"`
17441780
17451781 Deleted object type.
from line 1783
17471783 For Skill Versions, this is always `"skill_version_deleted"`.
17481784
17491785 default: skill_version_deleted
1786
1787 - `id: string`
1788
1789 Unique identifier for this Skill Version. The id addresses the version in
1790 paths and pins it in references.
17501791
17511792#### Example
17521793