Create Skill
Upload a new Skill for agents to use in sessions.
/anthropic/v1/skills○ UnsupportedRequest body
filesarray必填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_namestring可选Human-readable, single-line label for the Skill. Maximum 255 characters. Always set: derived from the SKILL.md frontmatter `name` when omitted at creation. Not unique.
Returns
501 This endpoint is not implemented yet; calling it returns the response below:
Uploading and managing Skills is not supported yet; passing skills when creating an agent returns 400. Calling it returns 501 (not_implemented_error), produces no side effects, and the official SDK does not retry.
Errors follow the Claude Managed Agents format — see error codes
Response
HTTP 200
Successful response
multipart/form-data
| Name | Type | Description |
|---|---|---|
| id | string | Unique identifier for the skill. The format and length of IDs may change over time. |
| created_at | string | ISO 8601 timestamp of when the skill was created. |
| display_name | string | Human-readable, single-line label for the Skill. Maximum 255 characters. Always set: derived from the SKILL.md frontmatter `name` when omitted at creation. Not unique. |
| latest_version_id | string | ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version. |
| source | object | Where the Skill comes from. Possible values: - `"custom"`: authored by the platform user; private to their workspace - `"anthropic"`: published by Anthropic; shared and read-only - `"anthropic_example"`: Anthropic-published sample Skill - `"plugin"`: resolved from an installed plugin |
| source.type | string | Where the Skill comes from. Possible values: - `"custom"`: authored by the platform user; private to their workspace - `"anthropic"`: published by Anthropic; shared and read-only - `"anthropic_example"`: Anthropic-published sample Skill - `"plugin"`: resolved from an installed plugin |
| type | string | Object type. For Skills, this is always `"skill"`. |
| updated_at | string | ISO 8601 timestamp of when the skill was last updated. |