Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
One change · api

skills-guide changed

build-with-claude/skills-guide

Nearest release: v2.1.277, 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+5added
Lines−5removed
From line 2,166 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits13to this page, all time

The whole hunk

from line 2166, old and new numbered
/
lines
from line 2166
21662166 
21672167Files are identified by the filename you attach (the `;filename=` suffix in the cURL example and the filename arguments in the SDK examples). For the walkthrough's skill, create a zip with `zip -r financial_skill.zip financial_skill/` and substitute it for the `example_skill.zip` placeholder in the zip-upload options.
21682168 
2169<CodeGroup defaultLanguage="CLI">
2169<CodeGroup>
21702170 ```bash cURL
21712171 curl -X POST "https://api.anthropic.com/v1/skills" \
21722172 -H "x-api-key: $ANTHROPIC_API_KEY" \
from line 2471
24712471 
24722472Retrieve all Skills available to your workspace, including both Anthropic pre-built Skills and your custom Skills. Use the `source` parameter to filter by skill type:
24732473 
2474<CodeGroup defaultLanguage="CLI">
2474<CodeGroup>
24752475 ```bash cURL
24762476 # List all Skills
24772477 curl "https://api.anthropic.com/v1/skills" \
from line 2617
26172617 
26182618Get details about a specific Skill:
26192619 
2620<CodeGroup defaultLanguage="CLI">
2620<CodeGroup>
26212621 ```bash cURL
26222622 curl "https://api.anthropic.com/v1/skills/skill_01AbCdEfGhIjKlMnOpQrStUv" \
26232623 -H "x-api-key: $ANTHROPIC_API_KEY" \
from line 2714
27142714 
27152715Deleting a Skill also removes all of its versions.
27162716 
2717<CodeGroup defaultLanguage="CLI">
2717<CodeGroup>
27182718 ```bash cURL
27192719 curl -X DELETE "https://api.anthropic.com/v1/skills/skill_01AbCdEfGhIjKlMnOpQrStUv" \
27202720 -H "x-api-key: $ANTHROPIC_API_KEY" \
from line 2795
27952795 
27962796A new version is a complete snapshot, not a delta: upload the Skill's full file set each time. Files you omit are not carried over, and the `name` in the new version's `SKILL.md` must match the Skill's existing name. The following examples re-upload the complete `financial_skill/` bundle from [Creating a Skill](https://platform.claude.com/docs/en/build-with-claude/skills-guide#creating-a-skill).
27972797 
2798<CodeGroup defaultLanguage="CLI">
2798<CodeGroup>
27992799 ```bash cURL
28002800 # Create a new version
28012801 NEW_VERSION=$(curl -X POST "https://api.anthropic.com/v1/skills/skill_01AbCdEfGhIjKlMnOpQrStUv/versions" \