Create Skill
api/beta/skills/create
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
api/beta/skills/create Changed · +23 / -12 lines
# Create Skill ## Headers ## Body parameters (form-data) ## Returns ## Example ### Response (200) ## Create Skill ### Header Parameters ### Returns ### Example #### Response
---- -title: Create Skill -url: https://platform.claude.com/docs/en/api/beta/skills/create ---- +# Create Skill -## Create Skill +**POST** `/v1/skills` -**post** `/v1/skills` - Create Skill -### Header Parameters +## Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +## Body parameters (form-data) +- `files: array of string` + + 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. + +- `display_title: optional string or null` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + +## Returns + - `id: string` Unique identifier for the skill.
For Skills, this is always `"skill"`. + default: skill + - `updated_at: string` ISO 8601 timestamp of when the skill was last updated. -### Example +## Example -```http +```bash curl https://api.anthropic.com/v1/skills \ -H 'Content-Type: multipart/form-data' \ -H 'anthropic-version: 2023-06-01' \
-F files='["Example data"]' ``` -#### Response +### Response (200) ```json {