Repository Public
1---2title: Create Skill3url: https://platform.claude.com/docs/en/api/skills/create4---56# Create Skill78**POST** `/v1/skills`910Create Skill1112## Headers1314- `"anthropic-workspace-id": optional string`1516## Body parameters (form-data)1718- `files: array of string`1920 Files to upload for the skill.2122 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.2324- `display_name: optional string or null`2526 Human-readable, single-line label for the Skill. Maximum 255 characters.27 Always set: derived from the SKILL.md frontmatter `name` when omitted at28 creation. Not unique.2930## Returns3132- `Skill object`3334 - `type: "skill"`3536 Object type.3738 For Skills, this is always `"skill"`.3940 default: skill4142 - `id: string`4344 Unique identifier for the skill.4546 The format and length of IDs may change over time.4748 - `created_at: string`4950 ISO 8601 timestamp of when the skill was created.5152 format: date-time5354 - `display_name: string`5556 Human-readable, single-line label for the Skill. Maximum 255 characters.57 Always set: derived from the SKILL.md frontmatter `name` when omitted at58 creation. Not unique.5960 - `latest_version_id: string`6162 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.6364 - `source: SkillSource`6566 Where the Skill comes from.6768 Possible values:6970 * `"custom"`: authored by the platform user; private to their workspace71 * `"anthropic"`: published by Anthropic; shared and read-only72 * `"anthropic_example"`: Anthropic-published sample Skill73 * `"plugin"`: resolved from an installed plugin7475 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`7677 Where the Skill comes from.7879 Possible values:8081 * `"custom"`: authored by the platform user; private to their workspace82 * `"anthropic"`: published by Anthropic; shared and read-only83 * `"anthropic_example"`: Anthropic-published sample Skill84 * `"plugin"`: resolved from an installed plugin8586 - `"custom"`8788 - `"anthropic"`8990 - `"anthropic_example"`9192 - `"plugin"`9394 - `updated_at: string`9596 ISO 8601 timestamp of when the skill was last updated.9798 format: date-time99100## Example101102```bash103curl https://api.anthropic.com/v1/skills \104 -H 'Content-Type: multipart/form-data' \105 -H 'anthropic-version: 2023-06-01' \106 -H "X-Api-Key: $ANTHROPIC_API_KEY" \107 -F 'files[]=@/path/to/file'108```109110### Response (200)111112```json113{114 "id": "skill_01JAbcdefghijklmnopqrstuvw",115 "created_at": "2024-10-30T23:58:27.427722Z",116 "display_name": "display_name",117 "latest_version_id": "latest_version_id",118 "source": {119 "type": "custom"120 },121 "type": "skill",122 "updated_at": "2024-10-30T23:58:27.427722Z"123}124```125