Claude Platform Docs

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}

Get Skill Version

Parameters
skillID: string

Unique identifier for the skill.

The format and length of IDs may change over time.

version: string

Identifies the skill version: a version ID, or the literal latest for the skill's most recent version.

Requests carrying the skills-2025-10-02 beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").

betas?:optional list<AnthropicBeta>

Optional header to specify the beta version(s) you want to use.

workspaceID?:optional string
Returns
class SkillVersion { $type = 'skill_version'; $id; $createdAt; /* 3 more */ }
"skill_version" type

Object type.

For Skill Versions, this is always "skill_version".

string id

Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.

\Datetime createdAt

ISO 8601 timestamp of when the skill was created.

string description

Description of the skill version.

This is extracted from the SKILL.md file in the skill upload.

string name

The Skill's immutable kebab-case slug, set at creation from the first upload's SKILL.md frontmatter name (or its enclosing directory). Every later upload must resolve to the same value. Also the top-level directory of the Skill's mounted files and the base name of a downloaded archive.

string skillID

Unique identifier for the skill.

The format and length of IDs may change over time.

Get Skill Version
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'my-anthropic-api-key');

$betaSkillVersion = $client->beta->skills->versions->retrieve(
  'version',
  skillID: 'skill_id',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
  workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy',
);

var_dump($betaSkillVersion);
Returns Examples
Response 200
{
  "id": "id",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "description": "description",
  "name": "name",
  "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
  "type": "skill_version"
}