Claude Platform Docs

Skills

Create Skill
BetaSkill Beta.Skills.Create(parameters, cancellationToken = default)
POST/v1/skills
List Skills
SkillListPage Beta.Skills.List(parameters, cancellationToken = default)
GET/v1/skills
Get Skill
BetaSkill Beta.Skills.Retrieve(parameters, cancellationToken = default)
GET/v1/skills/{skill_id}
Delete Skill
BetaDeletedSkill Beta.Skills.Delete(parameters, cancellationToken = default)
DELETE/v1/skills/{skill_id}
Models
class BetaDeletedSkill { Type = "skill_deleted"; ID; }
JsonElement Type = "skill_deleted"

Deleted object type.

For Skills, this is always "skill_deleted".

required string ID

Unique identifier for the skill.

The format and length of IDs may change over time.

class BetaSkill { Type = "skill"; ID; CreatedAt; /* 4 more */ }
JsonElement Type = "skill"

Object type.

For Skills, this is always "skill".

required string ID

Unique identifier for the skill.

The format and length of IDs may change over time.

required DateTimeOffset CreatedAt

ISO 8601 timestamp of when the skill was created.

formatdate-time
required 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.

required string LatestVersionID

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

required BetaSkillSource 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
required 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")
AnthropicExample("anthropic_example")
Plugin("plugin")
required DateTimeOffset UpdatedAt

ISO 8601 timestamp of when the skill was last updated.

formatdate-time
class BetaSkillSource { Type; }
required 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")
AnthropicExample("anthropic_example")
Plugin("plugin")

SkillsVersions

Create Skill Version
BetaSkillVersion Beta.Skills.Versions.Create(parameters, cancellationToken = default)
POST/v1/skills/{skill_id}/versions
List Skill Versions
VersionListPage Beta.Skills.Versions.List(parameters, cancellationToken = default)
GET/v1/skills/{skill_id}/versions
Download Skill Version Content
HttpResponse Beta.Skills.Versions.Download(parameters, cancellationToken = default)
GET/v1/skills/{skill_id}/versions/{version}/content

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

Get Skill Version
BetaSkillVersion Beta.Skills.Versions.Retrieve(parameters, cancellationToken = default)
GET/v1/skills/{skill_id}/versions/{version}
Delete Skill Version
BetaDeletedSkillVersion Beta.Skills.Versions.Delete(parameters, cancellationToken = default)
DELETE/v1/skills/{skill_id}/versions/{version}