Create Skill - Claude Docs> Source: https://docs.claude.com/en/api/skills/create-skillAgent Skills are now available! Learn more about extending Claude's capabilities with Agent Skills.

Claude Docs home page English Search... ⌘K

• Console
• Support
• Discord
• Sign up
• Sign up

Search... Navigation Skill Management Create Skill HomeDeveloper GuideAPI ReferenceModel Context Protocol (MCP)ResourcesRelease Notes

Using the API

• Features overview
• Client SDKs
• Beta headers
• Errors

Messages

• POSTMessages
• POSTCount Message tokens

Models

• GETList Models
• GETGet a Model

Message Batches

• POSTCreate a Message Batch
• GETRetrieve a Message Batch
• GETRetrieve Message Batch Results
• GETList Message Batches
• POSTCancel a Message Batch
• DELDelete a Message Batch

Files

• POSTCreate a File
• GETList Files
• GETGet File Metadata
• GETDownload a File
• DELDelete a File

Skills

• Skill Management
  • POSTCreate Skill
  • GETList Skills
  • GETGet Skill
  • DELDelete Skill
• Skill Versions

Admin API

• Organization Info
• Organization Member Management
• Organization Invites
• Workspace Management
• Workspace Member Management
• API Keys
• Usage and Cost

Experimental APIs

• Prompt tools

Text Completions (Legacy)

• Migrating from Text Completions

Support & configuration

• Rate limits
• Service tiers
• Versions
• IP addresses
• Supported regions
• OpenAI SDK compatibility

cURL cURL Copy

curl -X POST "https://api.anthropic.com/v1/skills" \
     -H "x-api-key: $ANTHROPIC_API_KEY" \
     -H "anthropic-version: 2023-06-01" \
     -H "anthropic-beta: skills-2025-10-02" \
     -F "display_title=My Excel Skill" \
     -F "files[]=@excel-skill/SKILL.md;filename=excel-skill/SKILL.md" \
     -F "files[]=@excel-skill/process_excel.py;filename=excel-skill/process_excel.py"

200 4XX Copy

{
  "created_at": "2024-10-30T23:58:27.427722Z",
  "display_title": "My Custom Skill",
  "id": "skill_01JAbcdefghijklmnopqrstuvw",
  "latest_version": "1759178010641129",
  "source": "custom",
  "type": "skill",
  "updated_at": "2024-10-30T23:58:27.427722Z"
}

Skill Management

Create Skill

Copy page Copy page POST / v1 / skills cURL cURL Copy

curl -X POST "https://api.anthropic.com/v1/skills" \
     -H "x-api-key: $ANTHROPIC_API_KEY" \
     -H "anthropic-version: 2023-06-01" \
     -H "anthropic-beta: skills-2025-10-02" \
     -F "display_title=My Excel Skill" \
     -F "files[]=@excel-skill/SKILL.md;filename=excel-skill/SKILL.md" \
     -F "files[]=@excel-skill/process_excel.py;filename=excel-skill/process_excel.py"

200 4XX Copy

{
  "created_at": "2024-10-30T23:58:27.427722Z",
  "display_title": "My Custom Skill",
  "id": "skill_01JAbcdefghijklmnopqrstuvw",
  "latest_version": "1759178010641129",
  "source": "custom",
  "type": "skill",
  "updated_at": "2024-10-30T23:58:27.427722Z"
}

Headers

​ anthropic-beta string[] 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. ​ anthropic-version string required The version of the Claude API you want to use. Read more about versioning and our version history here. ​ x-api-key string required 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. Each key is scoped to a Workspace.

Body

multipart/form-data ​ display_title string | null Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. ​ files file[] | null Files to upload for the skill. All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.

Response

200 application/json Successful Response ​ created_at string required ISO 8601 timestamp of when the skill was created. Examples: "2024-10-30T23:58:27.427722Z" ​ display_title string | null required Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. Examples: "My Custom Skill" ​ id string required Unique identifier for the skill. The format and length of IDs may change over time. Examples: "skill_01JAbcdefghijklmnopqrstuvw" ​ latest_version string | null required The latest version identifier for the skill. This represents the most recent version of the skill that has been created. Examples: "1759178010641129" ​ source string required Source of the skill. This may be one of the following values:

• "custom": the skill was created by a user
• "anthropic": the skill was created by Anthropic

Examples: "custom" ​ type string default:skill required Object type. For Skills, this is always "skill". ​ updated_at string required ISO 8601 timestamp of when the skill was last updated. Examples: "2024-10-30T23:58:27.427722Z" Was this page helpful? YesNo Delete a FileList Skills Assistant Responses are generated using AI and may contain mistakes. Claude Docs home page xlinkedin Company AnthropicCareersEconomic FuturesResearchNewsTrust centerTransparency Help and security AvailabilityStatusSupport center Learn CoursesMCP connectorsCustomer storiesEngineering blogEventsPowered by ClaudeService partnersStartups program Terms and policies Privacy policyDisclosure policyUsage policyCommercial termsConsumer terms