Claude Platform Docs

Skills

Create Skill
client.beta.skills.create(SkillCreateParamsparams, RequestOptionsoptions?): SkillCreateResponse
POST/v1/skills
List Skills
client.beta.skills.list(SkillListParamsparams?, RequestOptionsoptions?): PageCursor<SkillListResponse>
GET/v1/skills
Get Skill
client.beta.skills.retrieve(stringskillID, SkillRetrieveParamsparams?, RequestOptionsoptions?): SkillRetrieveResponse
GET/v1/skills/{skill_id}
Delete Skill
client.beta.skills.delete(stringskillID, SkillDeleteParamsparams?, RequestOptionsoptions?): SkillDeleteResponse
DELETE/v1/skills/{skill_id}
Models
SkillCreateResponse { id, created_at, display_title, 4 more }
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_title: string | null

Display title for the skill.

This is a human-readable label that is not included in the prompt sent to the model.

latest_version: string | null

The latest version identifier for the skill.

This represents the most recent version of the skill that has been created.

source: string

Source of the skill.

This may be one of the following values:

  • "custom": the skill was created by a user
  • "anthropic": the skill was created by Anthropic
type: string

Object type.

For Skills, this is always "skill".

defaultskill
updated_at: string

ISO 8601 timestamp of when the skill was last updated.

SkillListResponse { id, created_at, display_title, 4 more }
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_title: string | null

Display title for the skill.

This is a human-readable label that is not included in the prompt sent to the model.

latest_version: string | null

The latest version identifier for the skill.

This represents the most recent version of the skill that has been created.

source: string

Source of the skill.

This may be one of the following values:

  • "custom": the skill was created by a user
  • "anthropic": the skill was created by Anthropic
type: string

Object type.

For Skills, this is always "skill".

defaultskill
updated_at: string

ISO 8601 timestamp of when the skill was last updated.

SkillRetrieveResponse { id, created_at, display_title, 4 more }
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_title: string | null

Display title for the skill.

This is a human-readable label that is not included in the prompt sent to the model.

latest_version: string | null

The latest version identifier for the skill.

This represents the most recent version of the skill that has been created.

source: string

Source of the skill.

This may be one of the following values:

  • "custom": the skill was created by a user
  • "anthropic": the skill was created by Anthropic
type: string

Object type.

For Skills, this is always "skill".

defaultskill
updated_at: string

ISO 8601 timestamp of when the skill was last updated.

SkillDeleteResponse { id, type }
id: string

Unique identifier for the skill.

The format and length of IDs may change over time.

type: string

Deleted object type.

For Skills, this is always "skill_deleted".

defaultskill_deleted

SkillsVersions

Create Skill Version
client.beta.skills.versions.create(stringskillID, VersionCreateParamsparams, RequestOptionsoptions?): VersionCreateResponse
POST/v1/skills/{skill_id}/versions
List Skill Versions
client.beta.skills.versions.list(stringskillID, VersionListParamsparams?, RequestOptionsoptions?): PageCursor<VersionListResponse>
GET/v1/skills/{skill_id}/versions
Download Skill Version Content
client.beta.skills.versions.download(stringversion, VersionDownloadParamsparams, RequestOptionsoptions?): Response
GET/v1/skills/{skill_id}/versions/{version}/content
Get Skill Version
client.beta.skills.versions.retrieve(stringversion, VersionRetrieveParamsparams, RequestOptionsoptions?): VersionRetrieveResponse
GET/v1/skills/{skill_id}/versions/{version}
Delete Skill Version
client.beta.skills.versions.delete(stringversion, VersionDeleteParamsparams, RequestOptionsoptions?): VersionDeleteResponse
DELETE/v1/skills/{skill_id}/versions/{version}