Claude Platform Docs

Skills

Create Skill
$client->beta->skills->create(list<string> files, ?string displayName, ?list<AnthropicBeta> betas, ?string workspaceID): BetaSkill
POST/v1/skills
List Skills
$client->beta->skills->list(?int limit, ?string page, ?string source, ?list<AnthropicBeta> betas, ?string workspaceID): PageCursor<BetaSkill>
GET/v1/skills
Get Skill
$client->beta->skills->retrieve(string skillID, ?list<AnthropicBeta> betas, ?string workspaceID): BetaSkill
GET/v1/skills/{skill_id}
Delete Skill
$client->beta->skills->delete(string skillID, ?list<AnthropicBeta> betas, ?string workspaceID): BetaDeletedSkill
DELETE/v1/skills/{skill_id}
Models
class BetaDeletedSkill { $type = 'skill_deleted'; $id; }
"skill_deleted" type

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 BetaSkill { $type = 'skill'; $id; $createdAt; /* 4 more */ }
"skill" type

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.

\Datetime createdAt

ISO 8601 timestamp of when the skill was created.

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.

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
\Datetime updatedAt

ISO 8601 timestamp of when the skill was last updated.

class BetaSkillSource { $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

SkillsVersions

Create Skill Version
$client->beta->skills->versions->create(string skillID, list<string> files, ?list<AnthropicBeta> betas, ?string workspaceID): SkillVersion
POST/v1/skills/{skill_id}/versions
List Skill Versions
$client->beta->skills->versions->list(string skillID, ?int limit, ?string page, ?list<AnthropicBeta> betas, ?string workspaceID): PageCursor<SkillVersion>
GET/v1/skills/{skill_id}/versions
Download Skill Version Content
$client->beta->skills->versions->download(string version, string skillID, ?list<AnthropicBeta> betas, ?string workspaceID): download
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->retrieve(string version, string skillID, ?list<AnthropicBeta> betas, ?string workspaceID): SkillVersion
GET/v1/skills/{skill_id}/versions/{version}
Delete Skill Version
$client->beta->skills->versions->delete(string version, string skillID, ?list<AnthropicBeta> betas, ?string workspaceID): DeletedSkillVersion
DELETE/v1/skills/{skill_id}/versions/{version}