Claude Platform Docs

Skills

Create Skill
Skill skills().create(SkillCreateParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
POST/v1/skills
List Skills
SkillListPage skills().list(SkillListParamsparams = SkillListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/skills
Get Skill
Skill skills().retrieve(SkillRetrieveParamsparams = SkillRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/skills/{skill_id}
Delete Skill
DeletedSkill skills().delete(SkillDeleteParamsparams = SkillDeleteParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
DELETE/v1/skills/{skill_id}
Models
class DeletedSkill:
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 Skill:
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.

SkillSource 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 SkillSource:
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
SkillVersion skills().versions().create(VersionCreateParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
POST/v1/skills/{skill_id}/versions
List Skill Versions
VersionListPage skills().versions().list(VersionListParamsparams = VersionListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/skills/{skill_id}/versions
Get Skill Version
SkillVersion skills().versions().retrieve(VersionRetrieveParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/skills/{skill_id}/versions/{version}
Delete Skill Version
DeletedSkillVersion skills().versions().delete(VersionDeleteParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
DELETE/v1/skills/{skill_id}/versions/{version}