Claude Platform Docs

Skills

Create Skill
client.Beta.Skills.New(ctx, params) (*BetaSkill, error)
POST/v1/skills
List Skills
client.Beta.Skills.List(ctx, params) (*PageCursor[BetaSkill], error)
GET/v1/skills
Get Skill
client.Beta.Skills.Get(ctx, skillID, query) (*BetaSkill, error)
GET/v1/skills/{skill_id}
Delete Skill
client.Beta.Skills.Delete(ctx, skillID, body) (*BetaDeletedSkill, error)
DELETE/v1/skills/{skill_id}
Models
type BetaDeletedSkill struct { Type: "skill_deleted"; ID }
Type SkillDeleted

Deleted object type.

For Skills, this is always "skill_deleted".

defaultskill_deleted
ID string

Unique identifier for the skill.

The format and length of IDs may change over time.

type BetaSkill struct { Type: "skill"; ID; CreatedAt; /* 4 more */ }
Type Skill

Object type.

For Skills, this is always "skill".

defaultskill
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 BetaSkillSource

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 BetaSkillSourceType

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 BetaSkillSourceTypeCustom BetaSkillSourceType = "custom"
const BetaSkillSourceTypeAnthropic BetaSkillSourceType = "anthropic"
const BetaSkillSourceTypeAnthropicExample BetaSkillSourceType = "anthropic_example"
const BetaSkillSourceTypePlugin BetaSkillSourceType = "plugin"
UpdatedAt Time

ISO 8601 timestamp of when the skill was last updated.

formatdate-time
type BetaSkillSource struct { Type }
Type BetaSkillSourceType

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 BetaSkillSourceTypeCustom BetaSkillSourceType = "custom"
const BetaSkillSourceTypeAnthropic BetaSkillSourceType = "anthropic"
const BetaSkillSourceTypeAnthropicExample BetaSkillSourceType = "anthropic_example"
const BetaSkillSourceTypePlugin BetaSkillSourceType = "plugin"

SkillsVersions

Create Skill Version
client.Beta.Skills.Versions.New(ctx, skillID, params) (*BetaSkillVersion, error)
POST/v1/skills/{skill_id}/versions
List Skill Versions
client.Beta.Skills.Versions.List(ctx, skillID, params) (*PageCursor[BetaSkillVersion], error)
GET/v1/skills/{skill_id}/versions
Download Skill Version Content
client.Beta.Skills.Versions.Download(ctx, version, params) (*Response, error)
GET/v1/skills/{skill_id}/versions/{version}/content

Download a skill version's content as a zip archive.

Get Skill Version
client.Beta.Skills.Versions.Get(ctx, version, params) (*BetaSkillVersion, error)
GET/v1/skills/{skill_id}/versions/{version}
Delete Skill Version
client.Beta.Skills.Versions.Delete(ctx, version, params) (*BetaDeletedSkillVersion, error)
DELETE/v1/skills/{skill_id}/versions/{version}