Claude Platform Docs

Skills

Create Skill
Skill skills().create(params, requestOptions = RequestOptions.none())
POST/v1/skills
List Skills
SkillListPage skills().list(params = SkillListParams.none(), requestOptions = RequestOptions.none())
GET/v1/skills
Get Skill
Skill skills().retrieve(params = SkillRetrieveParams.none(), requestOptions = RequestOptions.none())
GET/v1/skills/{skill_id}
Delete Skill
DeletedSkill skills().delete(params = SkillDeleteParams.none(), requestOptions = RequestOptions.none())
DELETE/v1/skills/{skill_id}
Models
class DeletedSkill { type = "skill_deleted"; id; }
JsonValue type = "skill_deleted"

Deleted object type.

For Skills, this is always "skill_deleted".

String id

Unique identifier for the skill.

The format and length of IDs may change over time.

class Skill { type = "skill"; id; createdAt; /* 4 more */ }
JsonValue type = "skill"

Object type.

For Skills, this is always "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")
LocalDateTime updatedAt

ISO 8601 timestamp of when the skill was last updated.

formatdate-time
class SkillSource { type; }
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(params, requestOptions = RequestOptions.none())
POST/v1/skills/{skill_id}/versions
List Skill Versions
VersionListPage skills().versions().list(params = VersionListParams.none(), requestOptions = RequestOptions.none())
GET/v1/skills/{skill_id}/versions
Get Skill Version
SkillVersion skills().versions().retrieve(params, requestOptions = RequestOptions.none())
GET/v1/skills/{skill_id}/versions/{version}
Delete Skill Version
DeletedSkillVersion skills().versions().delete(params, requestOptions = RequestOptions.none())
DELETE/v1/skills/{skill_id}/versions/{version}