Claude Platform Docs

Skills

Create Skill
BetaSkill beta().skills().create(SkillCreateParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
POST/v1/skills
List Skills
SkillListPage beta().skills().list(SkillListParamsparams = SkillListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/skills
Get Skill
BetaSkill beta().skills().retrieve(SkillRetrieveParamsparams = SkillRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/skills/{skill_id}
Delete Skill
BetaDeletedSkill beta().skills().delete(SkillDeleteParamsparams = SkillDeleteParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
DELETE/v1/skills/{skill_id}
Models
class BetaDeletedSkill:
String id

Unique identifier for the skill.

The format and length of IDs may change over time.

JsonValue type "skill_deleted"constant

Deleted object type.

For Skills, this is always "skill_deleted".

class BetaSkill:
String id

Unique identifier for the skill.

The format and length of IDs may change over time.

LocalDateTime createdAt

ISO 8601 timestamp of when the skill was created.

formatdate-time
String displayName

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.

String latestVersionId

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

BetaSkillSource source

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 type

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
One of the following:
CUSTOM("custom")
ANTHROPIC("anthropic")
ANTHROPIC_EXAMPLE("anthropic_example")
PLUGIN("plugin")
JsonValue type "skill"constant

Object type.

For Skills, this is always "skill".

LocalDateTime updatedAt

ISO 8601 timestamp of when the skill was last updated.

formatdate-time
class BetaSkillSource:
Type type

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
One of the following:
CUSTOM("custom")
ANTHROPIC("anthropic")
ANTHROPIC_EXAMPLE("anthropic_example")
PLUGIN("plugin")

SkillsVersions

Create Skill Version
BetaSkillVersion beta().skills().versions().create(VersionCreateParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
POST/v1/skills/{skill_id}/versions
List Skill Versions
VersionListPage beta().skills().versions().list(VersionListParamsparams = VersionListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/skills/{skill_id}/versions
Download Skill Version Content
HttpResponse beta().skills().versions().download(VersionDownloadParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/skills/{skill_id}/versions/{version}/content
Get Skill Version
BetaSkillVersion beta().skills().versions().retrieve(VersionRetrieveParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/skills/{skill_id}/versions/{version}
Delete Skill Version
BetaDeletedSkillVersion beta().skills().versions().delete(VersionDeleteParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
DELETE/v1/skills/{skill_id}/versions/{version}