Repository Public
1---2title: Create Skill3url: https://platform.claude.com/docs/en/api/beta/skills/create4---56# Create Skill78**POST** `/v1/skills`910Create Skill1112## Headers1314- `"anthropic-beta": optional array of AnthropicBeta`1516 Optional header to specify the beta version(s) you want to use.1718 - `string`1920 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`2122 - `"message-batches-2024-09-24"`2324 - `"prompt-caching-2024-07-31"`2526 - `"computer-use-2024-10-22"`2728 - `"computer-use-2025-01-24"`2930 - `"pdfs-2024-09-25"`3132 - `"token-counting-2024-11-01"`3334 - `"token-efficient-tools-2025-02-19"`3536 - `"output-128k-2025-02-19"`3738 - `"files-api-2025-04-14"`3940 - `"mcp-client-2025-04-04"`4142 - `"mcp-client-2025-11-20"`4344 - `"dev-full-thinking-2025-05-14"`4546 - `"interleaved-thinking-2025-05-14"`4748 - `"code-execution-2025-05-22"`4950 - `"extended-cache-ttl-2025-04-11"`5152 - `"context-1m-2025-08-07"`5354 - `"context-management-2025-06-27"`5556 - `"model-context-window-exceeded-2025-08-26"`5758 - `"skills-2025-10-02"`5960 - `"fast-mode-2026-02-01"`6162 - `"output-300k-2026-03-24"`6364 - `"user-profiles-2026-03-24"`6566 - `"user-profiles-2026-08-18"`6768 - `"user-profiles-2026-09-04"`6970 - `"advisor-tool-2026-03-01"`7172 - `"managed-agents-2026-04-01"`7374 - `"cache-diagnosis-2026-04-07"`7576 - `"dreaming-2026-04-21"`7778 - `"thinking-token-count-2026-05-13"`7980 - `"server-side-fallback-2026-06-01"`8182 - `"server-side-fallback-2026-07-01"`8384 - `"fallback-credit-2026-06-01"`8586 - `"fallback-credit-2026-07-01"`8788 - `"agent-memory-2026-07-22"`8990 - `"mid-conversation-tool-changes-2026-07-01"`9192 - `"compact-2026-01-12"`9394 - `"computer-use-2025-11-24"`9596 - `"mcp-tunnels-2026-06-22"`9798 - `"structured-outputs-2025-11-13"`99100 - `"task-budgets-2026-03-13"`101102 - `"thinking-display-updates-2026-08-18"`103104 - `"ce-user-management-2026-07-13"`105106 - `"mid-conversation-output-config-2026-07-01"`107108 - `"thinking-binding-controls-2026-08-01"`109110 - `"mid-conversation-system-clear-at-2026-08-21"`111112 - `"compact-2026-09-04"`113114- `"anthropic-workspace-id": optional string`115116## Body parameters (form-data)117118- `files: array of string`119120 Files to upload for the skill.121122 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.123124- `display_name: optional string or null`125126 Human-readable, single-line label for the Skill. Maximum 255 characters.127 Always set: derived from the SKILL.md frontmatter `name` when omitted at128 creation. Not unique.129130## Returns131132- `BetaSkill object`133134 - `type: "skill"`135136 Object type.137138 For Skills, this is always `"skill"`.139140 default: skill141142 - `id: string`143144 Unique identifier for the skill.145146 The format and length of IDs may change over time.147148 - `created_at: string`149150 ISO 8601 timestamp of when the skill was created.151152 format: date-time153154 - `display_name: string`155156 Human-readable, single-line label for the Skill. Maximum 255 characters.157 Always set: derived from the SKILL.md frontmatter `name` when omitted at158 creation. Not unique.159160 - `latest_version_id: string`161162 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.163164 - `source: BetaSkillSource`165166 Where the Skill comes from.167168 Possible values:169170 * `"custom"`: authored by the platform user; private to their workspace171 * `"anthropic"`: published by Anthropic; shared and read-only172 * `"anthropic_example"`: Anthropic-published sample Skill173 * `"plugin"`: resolved from an installed plugin174175 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`176177 Where the Skill comes from.178179 Possible values:180181 * `"custom"`: authored by the platform user; private to their workspace182 * `"anthropic"`: published by Anthropic; shared and read-only183 * `"anthropic_example"`: Anthropic-published sample Skill184 * `"plugin"`: resolved from an installed plugin185186 - `"custom"`187188 - `"anthropic"`189190 - `"anthropic_example"`191192 - `"plugin"`193194 - `updated_at: string`195196 ISO 8601 timestamp of when the skill was last updated.197198 format: date-time199200## Example201202```bash203curl https://api.anthropic.com/v1/skills \204 -H 'Content-Type: multipart/form-data' \205 -H 'anthropic-version: 2023-06-01' \206 -H "X-Api-Key: $ANTHROPIC_API_KEY" \207 -F 'files[]=@/path/to/file'208```209210### Response (200)211212```json213{214 "id": "skill_01JAbcdefghijklmnopqrstuvw",215 "created_at": "2024-10-30T23:58:27.427722Z",216 "display_name": "display_name",217 "latest_version_id": "latest_version_id",218 "source": {219 "type": "custom"220 },221 "type": "skill",222 "updated_at": "2024-10-30T23:58:27.427722Z"223}224```225