---
title: "Create Skill"
method: POST
path: "/v1/skills"
---

# Create Skill

`POST /v1/skills`

## Headers

- `anthropic-version` string — The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).

## Response `200`

Successful Response

- Skill
  - `created_at` string, date-time, required — ISO 8601 timestamp of when the skill was created.
  - `display_name` string, required — 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.
  - `id` string, required — Unique identifier for the skill. The format and length of IDs may change over time.
  - `latest_version_id` string, required — ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
  - `source` SkillSource, required
    - `type` 'custom' | 'anthropic' | 'anthropic_example' | 'plugin', required — 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` 'skill', required — Object type. For Skills, this is always `"skill"`.
  - `updated_at` string, date-time, required — ISO 8601 timestamp of when the skill was last updated.

## Other responses

- `4XX` — Error response. See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.

---

[API](https://skmtc.net/anthropics/apis/anthropic-api.md) · [All operations](https://skmtc.net/anthropics/apis/anthropic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anthropics/anthropic-api/revisions/0042750ea1ee/schema)