skills-guide changedbuild-with-claude/skills-guide
Nearest release: v2.1.318, published 4 hours before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+22added
Lines−22removed
From line
76
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits27to this page, all time
The whole hunk
from line 76, old and new numbered
/
from line 76
7676 ```bash cURL
7777 curl https://api.anthropic.com/v1/messages \
7878 -H "x-api-key: $ANTHROPIC_API_KEY" \
79 -H "anthropic-version: 2023-06-01" \
79 -H "anthropic-version: 2026-10-21" \
8080 -H "content-type: application/json" \
8181 -d '{
8282 "model": "claude-opus-5-5",
from line 698
698698 # Get file metadata
699699 curl "https://api.anthropic.com/v1/files/$FILE_ID" \
700700 -H "x-api-key: $ANTHROPIC_API_KEY" \
701 -H "anthropic-version: 2023-06-01"
701 -H "anthropic-version: 2026-10-21"
702702
703703 # List all files
704704 curl "https://api.anthropic.com/v1/files" \
705705 -H "x-api-key: $ANTHROPIC_API_KEY" \
706 -H "anthropic-version: 2023-06-01"
706 -H "anthropic-version: 2026-10-21"
707707
708708 # Delete a file
709709 curl -X DELETE "https://api.anthropic.com/v1/files/$FILE_ID" \
710710 -H "x-api-key: $ANTHROPIC_API_KEY" \
711 -H "anthropic-version: 2023-06-01"
711 -H "anthropic-version: 2026-10-21"
712712 ```
713713
714714 ```bash CLI
from line 1620
16201620</CodeGroup>
16211621
16221622<Note>
1623 The response might include a `pause_turn` stop reason, which indicates that the API paused a long-running Skill operation. You can provide the response back as-is in a subsequent request to let Claude continue its turn, or modify the content if you want to interrupt the conversation and provide additional guidance.
1623 The response might include a `pause_turn` stop reason, which indicates that the API paused a long-running Skill operation. You can provide the response back as-is in a subsequent request to let Claude continue its turn, or modify the content if you want to interrupt the conversation and provide additional guidance. Send the response’s container ID back with that request, in the same `container` object as your Skills, as the example does. Without it, the request runs in a new container, and files from earlier in the turn are lost.
16241624</Note>
16251625
16261626### Using multiple Skills
from line 1631
16311631 ```bash cURL
16321632 curl https://api.anthropic.com/v1/messages \
16331633 -H "x-api-key: $ANTHROPIC_API_KEY" \
1634 -H "anthropic-version: 2023-06-01" \
1634 -H "anthropic-version: 2026-10-21" \
16351635 -H "content-type: application/json" \
16361636 -d '{
16371637 "model": "claude-opus-5-5",
from line 1956
19561956
19571957### Creating a Skill
19581958
1959A Skill bundle is a directory containing a `SKILL.md` file at the top level with `name` and `description` YAML frontmatter, plus any supporting scripts or resources. See [Get started with Agent Skills in the API](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/quickstart) to author one, and the **Requirements** list following the examples for the full constraints.
1959A Skill bundle is a directory containing a `SKILL.md` file at the top level with `name` and `description` YAML frontmatter, plus any supporting scripts or resources. See [Skill authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) to author one, and the **Requirements** list following the examples for the full constraints.
19601960
19611961Upload your custom Skill to make it available in your workspace. You can upload a zip archive or individual file objects. The Python SDK also provides a `files_from_dir` helper that accepts a directory path, and the CLI’s `ant apply` uploads the directory itself.
19621962
from line 1966
19661966 ```bash cURL
19671967 curl -X POST "https://api.anthropic.com/v1/skills" \
19681968 -H "x-api-key: $ANTHROPIC_API_KEY" \
1969 -H "anthropic-version: 2023-06-01" \
1969 -H "anthropic-version: 2026-10-21" \
19701970 -F "files[]=@financial_skill/SKILL.md;filename=financial_skill/SKILL.md" \
19711971 -F "files[]=@financial_skill/analyze.py;filename=financial_skill/analyze.py"
19721972 ```
from line 2271
22712271 # List all Skills
22722272 curl "https://api.anthropic.com/v1/skills" \
22732273 -H "x-api-key: $ANTHROPIC_API_KEY" \
2274 -H "anthropic-version: 2023-06-01"
2274 -H "anthropic-version: 2026-10-21"
22752275
22762276 # List only custom Skills
22772277 curl "https://api.anthropic.com/v1/skills?source=custom" \
22782278 -H "x-api-key: $ANTHROPIC_API_KEY" \
2279 -H "anthropic-version: 2023-06-01"
2279 -H "anthropic-version: 2026-10-21"
22802280 ```
22812281
22822282 ```bash CLI
from line 2416
24162416 ```bash cURL
24172417 curl "https://api.anthropic.com/v1/skills/skill_01AbCdEfGhIjKlMnOpQrStUv" \
24182418 -H "x-api-key: $ANTHROPIC_API_KEY" \
2419 -H "anthropic-version: 2023-06-01"
2419 -H "anthropic-version: 2026-10-21"
24202420 ```
24212421
24222422 ```bash CLI
from line 2513
25132513 ```bash cURL
25142514 curl -X DELETE "https://api.anthropic.com/v1/skills/skill_01AbCdEfGhIjKlMnOpQrStUv" \
25152515 -H "x-api-key: $ANTHROPIC_API_KEY" \
2516 -H "anthropic-version: 2023-06-01"
2516 -H "anthropic-version: 2026-10-21"
25172517 ```
25182518
25192519 ```bash CLI
from line 2595
25952595 # Create a new version
25962596 curl -X POST "https://api.anthropic.com/v1/skills/skill_01AbCdEfGhIjKlMnOpQrStUv/versions" \
25972597 -H "x-api-key: $ANTHROPIC_API_KEY" \
2598 -H "anthropic-version: 2023-06-01" \
2598 -H "anthropic-version: 2026-10-21" \
25992599 -F "files[]=@financial_skill/SKILL.md;filename=financial_skill/SKILL.md" \
26002600 -F "files[]=@financial_skill/analyze.py;filename=financial_skill/analyze.py"
26012601
from line 2602
26022602 # Use a specific version: the ID from the create response
26032603 curl https://api.anthropic.com/v1/messages \
26042604 -H "x-api-key: $ANTHROPIC_API_KEY" \
2605 -H "anthropic-version: 2023-06-01" \
2605 -H "anthropic-version: 2026-10-21" \
26062606 -H "content-type: application/json" \
26072607 -d '{
26082608 "model": "claude-opus-5-5",
from line 2621
26212621 # Use latest version
26222622 curl https://api.anthropic.com/v1/messages \
26232623 -H "x-api-key: $ANTHROPIC_API_KEY" \
2624 -H "anthropic-version: 2023-06-01" \
2624 -H "anthropic-version: 2026-10-21" \
26252625 -H "content-type: application/json" \
26262626 -d '{
26272627 "model": "claude-opus-5-5",
from line 3134
31343134 ```bash cURL
31353135 curl -X POST "https://api.anthropic.com/v1/skills" \
31363136 -H "x-api-key: $ANTHROPIC_API_KEY" \
3137 -H "anthropic-version: 2023-06-01" \
3137 -H "anthropic-version: 2026-10-21" \
31383138 -F "files[]=@dcf_skill/SKILL.md;filename=dcf_skill/SKILL.md"
31393139 ```
31403140
from line 3264
32643264 ```bash cURL
32653265 curl https://api.anthropic.com/v1/messages \
32663266 -H "x-api-key: $ANTHROPIC_API_KEY" \
3267 -H "anthropic-version: 2023-06-01" \
3267 -H "anthropic-version: 2026-10-21" \
32683268 -H "content-type: application/json" \
32693269 -d '{
32703270 "model": "claude-opus-5-5",
from line 3588
35883588 # Pin to specific versions for stability
35893589 curl https://api.anthropic.com/v1/messages \
35903590 -H "x-api-key: $ANTHROPIC_API_KEY" \
3591 -H "anthropic-version: 2023-06-01" \
3591 -H "anthropic-version: 2026-10-21" \
35923592 -H "content-type: application/json" \
35933593 -d '{
35943594 "model": "claude-opus-5-5",
from line 3729
37293729 # Use latest for active development
37303730 curl https://api.anthropic.com/v1/messages \
37313731 -H "x-api-key: $ANTHROPIC_API_KEY" \
3732 -H "anthropic-version: 2023-06-01" \
3732 -H "anthropic-version: 2026-10-21" \
37333733 -H "content-type: application/json" \
37343734 -d '{
37353735 "model": "claude-opus-5-5",
from line 3872
38723872 # Skills render into the system prompt in a fixed, cache-friendly order
38733873 curl https://api.anthropic.com/v1/messages \
38743874 -H "x-api-key: $ANTHROPIC_API_KEY" \
3875 -H "anthropic-version: 2023-06-01" \
3875 -H "anthropic-version: 2026-10-21" \
38763876 -H "content-type: application/json" \
38773877 -d '{
38783878 "model": "claude-opus-5-5",
from line 3889
38893889 # Changing the Skills list ([xlsx] versus [xlsx, pptx]) changes the prefix: a cache miss, whereas an identical list is a cache hit
38903890 curl https://api.anthropic.com/v1/messages \
38913891 -H "x-api-key: $ANTHROPIC_API_KEY" \
3892 -H "anthropic-version: 2023-06-01" \
3892 -H "anthropic-version: 2026-10-21" \
38933893 -H "content-type: application/json" \
38943894 -d '{
38953895 "model": "claude-opus-5-5",
from line 4501
45014501
45024502## Migrate from `skills-2025-10-02`
45034503
4504The Skills API is out of beta and needs no beta header. Migrating off `skills-2025-10-02` is optional: requests that still send it keep working and keep returning the beta response shapes, so an existing integration keeps working until you change it. Removing the header switches those requests to the shapes documented on this page:
4504The Skills API is out of beta and needs no beta header. Migrating off `skills-2025-10-02` is optional: requests that send it keep working and keep returning the beta response shapes, so an existing integration keeps working until you change it. Removing the header switches those requests to the shapes documented on this page:
45054505
45064506| | With `skills-2025-10-02` | Without the header |
45074507| ------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
No line in this hunk matches that.