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{…}
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 BetaSkill 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 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"
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 BetaSkillSource struct{…}
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
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}