Skip to main content
GET
Get skill metadata and file manifest

Authorizations

Authorization
string
header
required

Effective API key. Send Authorization: Bearer sk-eai-...

Path Parameters

skillId
string
required

Opaque skill ID returned by listSkills: a bundled source/name ID or a team/project UUID.

Maximum string length: 74
Example:

"effective:effective"

Response

The skill and its files.

id
string
required

Opaque skill ID returned by listSkills: a bundled source/name ID or a team/project UUID.

Maximum string length: 74
Example:

"effective:effective"

name
string
required

Skill name, as its SKILL.md frontmatter declares it: lowercase words joined by hyphens. Install the skill in a folder of this name, such as ~/.claude/skills/<name>/.

Maximum string length: 64
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
Example:

"effective"

description
string
required

The SKILL.md frontmatter description: what the skill does and when to use it.

source
enum<string>
required

Where the skill comes from: effective, team or project.

Available options:
effective,
team,
project
contentHash
string
required

Hash of the skill folder's file paths and bytes. It changes exactly when the skill's content changes, so a client that stored it can tell whether its copy is current. The ETag of downloadSkill is this value, quoted.

Pattern: ^sha256:[0-9a-f]{64}$
fileCount
integer
required

Files in the skill folder, SKILL.md included.

Required range: x >= 1
sizeBytes
integer
required

Total size of those files, in bytes.

Required range: x >= 0
files
object[]
required

Every file in the skill folder, ordered by path.

publicationId
string<uuid>
scope
object