Claude Platform Docs

Skills

Create Skill
beta.skills.create(SkillCreateParams**kwargs) -> SkillCreateResponse
POST/v1/skills
List Skills
beta.skills.list(SkillListParams**kwargs) -> SyncPageCursor[SkillListResponse]
GET/v1/skills
Get Skill
beta.skills.retrieve(strskill_id, SkillRetrieveParams**kwargs) -> SkillRetrieveResponse
GET/v1/skills/{skill_id}
Delete Skill
beta.skills.delete(strskill_id, SkillDeleteParams**kwargs) -> SkillDeleteResponse
DELETE/v1/skills/{skill_id}
Models
class SkillCreateResponse: …
id: str

Unique identifier for the skill.

The format and length of IDs may change over time.

created_at: str

ISO 8601 timestamp of when the skill was created.

display_title: Optional[str]

Display title for the skill.

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

latest_version: Optional[str]

The latest version identifier for the skill.

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

source: str

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: str

Object type.

For Skills, this is always "skill".

defaultskill
updated_at: str

ISO 8601 timestamp of when the skill was last updated.

class SkillListResponse: …
id: str

Unique identifier for the skill.

The format and length of IDs may change over time.

created_at: str

ISO 8601 timestamp of when the skill was created.

display_title: Optional[str]

Display title for the skill.

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

latest_version: Optional[str]

The latest version identifier for the skill.

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

source: str

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: str

Object type.

For Skills, this is always "skill".

defaultskill
updated_at: str

ISO 8601 timestamp of when the skill was last updated.

class SkillRetrieveResponse: …
id: str

Unique identifier for the skill.

The format and length of IDs may change over time.

created_at: str

ISO 8601 timestamp of when the skill was created.

display_title: Optional[str]

Display title for the skill.

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

latest_version: Optional[str]

The latest version identifier for the skill.

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

source: str

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: str

Object type.

For Skills, this is always "skill".

defaultskill
updated_at: str

ISO 8601 timestamp of when the skill was last updated.

class SkillDeleteResponse: …
id: str

Unique identifier for the skill.

The format and length of IDs may change over time.

type: str

Deleted object type.

For Skills, this is always "skill_deleted".

defaultskill_deleted

SkillsVersions

Create Skill Version
beta.skills.versions.create(strskill_id, VersionCreateParams**kwargs) -> VersionCreateResponse
POST/v1/skills/{skill_id}/versions
List Skill Versions
beta.skills.versions.list(strskill_id, VersionListParams**kwargs) -> SyncPageCursor[VersionListResponse]
GET/v1/skills/{skill_id}/versions
Download Skill Version Content
beta.skills.versions.download(strversion, VersionDownloadParams**kwargs) -> BinaryResponseContent
GET/v1/skills/{skill_id}/versions/{version}/content
Get Skill Version
beta.skills.versions.retrieve(strversion, VersionRetrieveParams**kwargs) -> VersionRetrieveResponse
GET/v1/skills/{skill_id}/versions/{version}
Delete Skill Version
beta.skills.versions.delete(strversion, VersionDeleteParams**kwargs) -> VersionDeleteResponse
DELETE/v1/skills/{skill_id}/versions/{version}