Claude Platform Docs

Skills

Create Skill
client.Skills.New(ctx, body) (*Skill, error)
POST/v1/skills
List Skills
client.Skills.List(ctx, query) (*PageCursor[Skill], error)
GET/v1/skills
Get Skill
client.Skills.Get(ctx, skillID) (*Skill, error)
GET/v1/skills/{skill_id}
Delete Skill
client.Skills.Delete(ctx, skillID) (*DeletedSkill, error)
DELETE/v1/skills/{skill_id}
Models
type DeletedSkill struct{…}
ID string

Unique identifier for the skill.

The format and length of IDs may change over time.

Type SkillDeleted

Deleted object type.

For Skills, this is always "skill_deleted".

defaultskill_deleted
type Skill struct{…}
ID string

Unique identifier for the skill.

The format and length of IDs may change over time.

CreatedAt Time

ISO 8601 timestamp of when the skill was created.

formatdate-time
DisplayName string

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.

LatestVersionID string

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

Source SkillSource

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 SkillSourceType

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:
const SkillSourceTypeCustom SkillSourceType = "custom"
const SkillSourceTypeAnthropic SkillSourceType = "anthropic"
const SkillSourceTypeAnthropicExample SkillSourceType = "anthropic_example"
const SkillSourceTypePlugin SkillSourceType = "plugin"
Type Skill

Object type.

For Skills, this is always "skill".

defaultskill
UpdatedAt Time

ISO 8601 timestamp of when the skill was last updated.

formatdate-time
type SkillSource struct{…}
Type SkillSourceType

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:
const SkillSourceTypeCustom SkillSourceType = "custom"
const SkillSourceTypeAnthropic SkillSourceType = "anthropic"
const SkillSourceTypeAnthropicExample SkillSourceType = "anthropic_example"
const SkillSourceTypePlugin SkillSourceType = "plugin"

SkillsVersions

Create Skill Version
client.Skills.Versions.New(ctx, skillID, body) (*SkillVersion, error)
POST/v1/skills/{skill_id}/versions
List Skill Versions
client.Skills.Versions.List(ctx, skillID, query) (*PageCursor[SkillVersion], error)
GET/v1/skills/{skill_id}/versions
Get Skill Version
client.Skills.Versions.Get(ctx, version, query) (*SkillVersion, error)
GET/v1/skills/{skill_id}/versions/{version}
Delete Skill Version
client.Skills.Versions.Delete(ctx, version, body) (*DeletedSkillVersion, error)
DELETE/v1/skills/{skill_id}/versions/{version}