latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-191441,1001.9 MB

0042750ea1ee

Create Skill

post/v1/skills

Headers

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Response

Successful Response

created_atstring date-time required

ISO 8601 timestamp of when the skill was created.

display_namestring 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.

idstring required

Unique identifier for the skill.

The format and length of IDs may change over time.

latest_version_idstring required

ID of the newest Skill Version — what latest references resolve to. Always set: a Skill holds at least one version.

type'skill' required

Object type.

For Skills, this is always "skill".

updated_atstring date-time required

ISO 8601 timestamp of when the skill was last updated.

Example response

{
  "created_at": "2024-10-30T23:58:27.427722Z",
  "id": "skill_01JAbcdefghijklmnopqrstuvw",
  "updated_at": "2024-10-30T23:58:27.427722Z"
}