Skip to main content
GET
Get a skill for local agents

Authorizations

Authorization
string
header
required

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

Path Parameters

skillId
string
required

Skill ID: its source and name, such as effective:effective. Stable while the skill keeps its name.

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

"effective:effective"

Response

The skill and its files.

id
string
required

Skill ID: its source and name, such as effective:effective. Stable while the skill keeps its name.

Maximum string length: 74
Pattern: ^effective:[a-z0-9]+(?:-[a-z0-9]+)*$
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: Effective's own skills.

Available options:
effective
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.