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.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/anthropic-skills-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Anthropic Skills API
servers:
- url: https://api.anthropic.com
tags:
- name: Skills
paths:
/v1/skills:
post:
summary: Create Skill
operationId: create_skill_v1_skills_post
parameters:
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
requestBody:
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/Body_create_skill_v1_skills_post'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Skill'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Skills
get:
summary: List Skills
operationId: list_skills_v1_skills_get
parameters:
- name: page
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'Pagination token for fetching a specific page of results.
Pass the value from a previous response''s `next_page` field to get the next page of results.'
x-stainless-pagination-property:
purpose: next_cursor_param
title: Page
description: 'Pagination token for fetching a specific page of results.
Pass the value from a previous response''s `next_page` field to get the next page of results.'
- name: limit
in: query
required: false
schema:
type: integer
description: 'Number of results to return per page.
Ranges from `1` to `1000`. Defaults to `20`.'
default: 20
title: Limit
minimum: 1
maximum: 1000
description: 'Number of results to return per page.
Ranges from `1` to `1000`. Defaults to `20`.'
- name: source
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'Filter skills by source.
If provided, only skills from the specified source will be returned:
* `"custom"`: only return user-created skills
* `"anthropic"`: only return Anthropic-created skills'
title: Source
description: 'Filter skills by source.
If provided, only skills from the specified source will be returned:
* `"custom"`: only return user-created skills
* `"anthropic"`: only return Anthropic-created skills'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: x-api-key
in: header
required: false
schema:
type: string
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
title: X-Api-Key
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ListSkillsResponse'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Skills
/v1/skills/{skill_id}:
get:
summary: Get Skill
operationId: get_skill_v1_skills__skill_id__get
parameters:
- name: skill_id
in: path
required: true
schema:
type: string
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
title: Skill Id
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: x-api-key
in: header
required: false
schema:
type: string
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
title: X-Api-Key
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Skill'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Skills
delete:
summary: Delete Skill
operationId: delete_skill_v1_skills__skill_id__delete
parameters:
- name: skill_id
in: path
required: true
schema:
type: string
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
title: Skill Id
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: x-api-key
in: header
required: false
schema:
type: string
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
title: X-Api-Key
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DeletedSkill'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Skills
/v1/skills/{skill_id}/versions:
post:
summary: Create Skill Version
operationId: create_skill_version_v1_skills__skill_id__versions_post
parameters:
- name: skill_id
in: path
required: true
schema:
type: string
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
title: Skill Id
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
requestBody:
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/Body_create_skill_version_v1_skills__skill_id__versions_post'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SkillVersion'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Skills
get:
summary: List Skill Versions
operationId: list_skill_versions_v1_skills__skill_id__versions_get
parameters:
- name: skill_id
in: path
required: true
schema:
type: string
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
title: Skill Id
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
- name: page
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Optionally set to the `next_page` token from the previous response.
x-stainless-pagination-property:
purpose: next_cursor_param
title: Page
description: Optionally set to the `next_page` token from the previous response.
- name: limit
in: query
required: false
schema:
anyOf:
- type: integer
minimum: 1
maximum: 1000
- type: 'null'
description: 'Number of results to return per page.
Ranges from `1` to `1000`. Defaults to `20`.'
title: Limit
default: 20
description: 'Number of results to return per page.
Ranges from `1` to `1000`. Defaults to `20`.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: x-api-key
in: header
required: false
schema:
type: string
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
title: X-Api-Key
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ListSkillVersionsResponse'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Skills
/v1/skills/{skill_id}/versions/{version}:
get:
summary: Get Skill Version
operationId: get_skill_version_v1_skills__skill_id__versions__version__get
parameters:
- name: skill_id
in: path
required: true
schema:
type: string
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
title: Skill Id
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
- name: version
in: path
required: true
schema:
type: string
description: 'Identifies the skill version: a version ID, or the literal `latest` for the skill''s most recent version.
Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").'
title: Version
description: 'Identifies the skill version: a version ID, or the literal `latest` for the skill''s most recent version.
Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: x-api-key
in: header
required: false
schema:
type: string
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
title: X-Api-Key
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SkillVersion'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Skills
delete:
summary: Delete Skill Version
operationId: delete_skill_version_v1_skills__skill_id__versions__version__delete
parameters:
- name: skill_id
in: path
required: true
schema:
type: string
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
title: Skill Id
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
- name: version
in: path
required: true
schema:
type: string
description: 'Identifies the skill version by its version ID.
Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").'
title: Version
description: 'Identifies the skill version by its version ID.
Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: x-api-key
in: header
required: false
schema:
type: string
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
title: X-Api-Key
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DeletedSkillVersion'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Skills
/v1/skills/{skill_id}/versions/{version}/content?beta=true:
get:
summary: Download Skill Version Content
description: Download a skill version's content as a zip archive.
operationId: beta_download_skill_version_content_v1_skills__skill_id__versions__version__content_get
parameters:
- name: skill_id
in: path
required: true
schema:
type: string
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
title: Skill Id
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
- name: version
in: path
required: true
schema:
type: string
description: 'Version identifier for the skill.
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").'
title: Version
description: 'Version identifier for the skill.
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").'
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: x-api-key
in: header
required: false
schema:
type: string
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
title: X-Api-Key
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
responses:
'200':
description: Successful Response
content:
application/zip:
schema:
type: string
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/zip:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Skills
/v1/skills/{skill_id}/versions/{version}?beta=true:
get:
summary: Get Skill Version
operationId: beta_get_skill_version_v1_skills__skill_id__versions__version__get
parameters:
- name: skill_id
in: path
required: true
schema:
type: string
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
title: Skill Id
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
- name: version
in: path
required: true
schema:
type: string
description: 'Version identifier for the skill.
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").'
title: Version
description: 'Version identifier for the skill.
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").'
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: x-api-key
in: header
required: false
schema:
type: string
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
title: X-Api-Key
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BetaGetSkillVersionResponse'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Skills
delete:
summary: Delete Skill Version
operationId: beta_delete_skill_version_v1_skills__skill_id__versions__version__delete
parameters:
- name: skill_id
in: path
required: true
schema:
type: string
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
title: Skill Id
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
- name: version
in: path
required: true
schema:
type: string
description: 'Version identifier for the skill.
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").'
title: Version
description: 'Version identifier for the skill.
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").'
- name: anthropic-beta
in: header
required: false
schema:
type: string
items:
type: string
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
title: Anthropic-Beta
x-stainless-override-schema:
x-stainless-param: betas
x-stainless-extend-default: true
type: array
description: Optional header to specify the beta version(s) you want to use.
items:
$ref: '#/components/schemas/AnthropicBeta'
description: 'Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.'
- name: anthropic-version
in: header
required: false
schema:
type: string
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
title: Anthropic-Version
description: 'The version of the Claude API you want to use.
Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).'
- name: x-api-key
in: header
required: false
schema:
type: string
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
title: X-Api-Key
description: 'Your unique API key for authentication.
This key is required in the header of all API requests, to authenticate your account and access Anthropic''s services. Get your API key through the [Console](https://console.anthropic.com/settings/keys). Each key is scoped to a Workspace.'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BetaDeleteSkillVersionResponse'
4XX:
description: 'Error response.
See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.'
content:
application/json:
schema:
$ref: '#/components/schemas/BetaErrorResponse'
tags:
- Skills
/v1/skills/{skill_id}/versions?beta=true:
post:
summary: Create Skill Version
operationId: beta_create_skill_version_v1_skills__skill_id__versions_post
parameters:
- name: skill_id
in: path
required: true
schema:
type: string
description: 'Unique identifier for the skill.
The format and length of IDs may change over time.'
title: Skill Id
description: 'Unique identifier for the skill.
# --- truncated at 32 KB (72 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/openapi/anthropic-skills-api-openapi.yml