skills-guide changedbuild-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 edits28to this page, all time
The whole hunk
from line 2166, old and new numbered
/
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" \
No line in this hunk matches that.