Anthropic

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.

GitHub OpenAPI

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

POST /v1/skills Upload a new skill with a display name · Create Skill #
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.
GET /v1/skills List skills on the plain skills endpoint · List Skills #
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.
GET /v1/skills/{skill_id} Get a skill on the plain endpoint · Get Skill #
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}.
DELETE /v1/skills/{skill_id} Delete a skill on the plain endpoint · Delete Skill #
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 #
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 #
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.
GET /v1/skills/{skill_id}?beta=true Get a skill via the beta flag · Get Skill #
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.
DELETE /v1/skills/{skill_id}?beta=true Delete a skill via the beta flag · Delete Skill #
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.
POST /v1/skills?beta=true Upload a new skill with a display title (beta) · Create Skill #
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.
GET /v1/skills?beta=true List skills via the beta flag · List Skills #
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

📖
Documentation
https://docs.anthropic.com/en/api/skills/create-skill

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/openapi/anthropic-skills-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/anthropic-skills-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

anthropic-skills-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Anthropic Skills API
servers:
- url: https://api.anthropic.com
tags:


# --- truncated at 32 KB (83 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/openapi/anthropic-skills-api-openapi.yml