Anthropic Skills API
Create and manage custom Agent Skills. Skills are filesystem-based directories of instructions, scripts, and resources that Claude loads on demand via progressive disclosure. Workspace-wide sharing. The Skills API is currently in beta and requires the skills-2025-10-02 beta header.
Operations 17
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
3 of 17 operations are conformant: apis.io called them with no credentials and the responses matched this contract; 3 more answered but could not be checked against a schema. Checked 2026-11-12. how this works · status file
Ask an LLM
“How do I upload a new Agent Skill from a set of files?”
“Can I give a new skill a display name when I create it on the plain endpoint?”
Tell an agent
Create a skill named {display_name} from files {files}.
Without the beta flag, upload skill files {files} as a new skill.
Ask an LLM
“Which Agent Skills are available to my account on /v1/skills without the beta flag?”
“Can I list only skills from a particular source?”
Tell an agent
On the plain endpoint, list skills whose source is {source}.
List {limit} skills per page without the beta query flag.
Ask an LLM
“What details does the plain skills endpoint return for one skill?”
“Can I look up a skill by ID without the beta query flag?”
Tell an agent
Look up skill {skill_id} on the plain endpoint.
Without the beta parameter, retrieve skill {skill_id}.
Ask an LLM
“How do I remove a custom skill using the non-beta-flag skills path?”
“Is deleting a skill from /v1/skills permanent?”
Tell an agent destructive · confirm first
Delete skill {skill_id} using the plain endpoint.
Without the beta parameter, erase skill {skill_id}.
POST
/v1/skills/{skill_id}/versions
Publish a new version of a skill (plain endpoint) · Create Skill Version
#
Ask an LLM
“How do I publish updated files as a new version of an existing skill without the beta flag?”
“Can I add a version to a skill through the plain versions path?”
Tell an agent
On the plain endpoint, publish files {files} as a new version of skill {skill_id}.
Without the beta parameter, add a version to skill {skill_id} from {files}.
GET
/v1/skills/{skill_id}/versions
List a skill's versions on the plain endpoint · List Skill Versions
conformant
#
Ask an LLM
“Which versions of a skill exist, listed without the beta query flag?”
“Can I page through every version of a skill on the plain path?”
Tell an agent
On the plain endpoint, list the versions of skill {skill_id}.
Show {limit} versions per page for skill {skill_id} without the beta flag.
GET
/v1/skills/{skill_id}/versions/{version}
Get one skill version on the plain endpoint · Get Skill Version
#
Ask an LLM
“What does a specific version of a skill contain, read without the beta flag?”
“Can I fetch a single skill version from the plain versions path?”
Tell an agent
Look up version {version} of skill {skill_id} on the plain endpoint.
Without the beta parameter, retrieve skill {skill_id} at version {version}.
DELETE
/v1/skills/{skill_id}/versions/{version}
Delete one skill version on the plain endpoint · Delete Skill Version
#
Ask an LLM
“How do I delete an old version of a skill without the beta query flag?”
“Can I remove a single version while keeping the skill itself?”
Tell an agent destructive · confirm first
Delete version {version} of skill {skill_id} using the plain endpoint.
Without the beta parameter, drop just version {version} from skill {skill_id}.
GET
/v1/skills/{skill_id}/versions/{version}/content?beta=true
Download a skill version as a zip · Download Skill Version Content
#
Ask an LLM
“How do I download the files behind a skill version?”
“Can I get a skill version's content as a zip archive?”
Tell an agent
Download skill {skill_id} version {version} as a zip.
Save the zip archive of version {version} of skill {skill_id}.
GET
/v1/skills/{skill_id}/versions/{version}?beta=true
Get one skill version via the beta flag · Get Skill Version
#
Ask an LLM
“What metadata does the beta endpoint return for one version of a skill?”
“Can I read a skill version's details with the beta query flag set?”
Tell an agent
Get beta skill {skill_id} version {version}.
Fetch version {version} of skill {skill_id} with the beta flag.
DELETE
/v1/skills/{skill_id}/versions/{version}?beta=true
Delete one skill version via the beta flag · Delete Skill Version
#
Ask an LLM
“How do I delete a skill version using the beta skills endpoint?”
“Does the beta flag change how a skill version gets deleted?”
Tell an agent destructive · confirm first
Delete beta skill {skill_id} version {version}.
Remove version {version} of skill {skill_id} through the beta flag.
POST
/v1/skills/{skill_id}/versions?beta=true
Publish a new version of a skill via the beta flag · Create Skill Version
#
Ask an LLM
“How do I push a new version of a skill using the beta endpoint?”
“Can I upload revised skill files as a version with the beta query flag?”
Tell an agent
Create a beta version of skill {skill_id} from files {files}.
With the beta flag, upload {files} as the latest version of skill {skill_id}.
GET
/v1/skills/{skill_id}/versions?beta=true
List a skill's versions via the beta flag · List Skill Versions
observed
#
Ask an LLM
“Which versions of a skill does the beta endpoint list?”
“Can I paginate a skill's version history with the beta query flag?”
Tell an agent
List beta versions of skill {skill_id}.
With the beta flag, page through skill {skill_id} versions {limit} at a time.
Ask an LLM
“What does the beta skills endpoint return for a single skill?”
“How do I read one skill's details with the beta query flag?”
Tell an agent
Get beta skill {skill_id}.
Fetch skill {skill_id} with the beta query flag set.
Ask an LLM
“Can I delete a whole skill through the beta skills endpoint?”
“What's the beta-flag call to remove a custom skill?”
Tell an agent destructive · confirm first
Delete beta skill {skill_id}.
Remove skill {skill_id} permanently through the beta flag.
Ask an LLM
“How do I create a skill with a display title using the beta endpoint?”
“Can I upload a brand-new skill's files through the beta flag?”
Tell an agent
Create a beta skill titled {display_title} from files {files}.
With the beta flag, upload {files} as a brand-new skill.
Ask an LLM
“Which skills does the beta skills listing return for my account?”
“Can I filter the beta skill list by where the skill came from?”
Tell an agent
List beta skills from source {source}.
With the beta flag, page through my skills {limit} at a time.
Documentation
Specifications
Schemas & Data
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-beta-create-skill-version-response-schema.json
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-beta-get-skill-version-response-schema.json
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-skill-schema.json
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-beta-get-skill-response-schema.json
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-skill-version-schema.json
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-beta-list-skill-versions-response-schema.json