Skip to main content
GET
One skill with every file, in path order (`SKILL.md` is the entry point). Any valid key may call it.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

If-None-Match
string

The ETag of an earlier answer: 304 while nothing changed.

Path Parameters

name
string
required

Response

The skill, with its ETag.

object
string
required
Allowed value: "skill"
name
string
required

The skill's name, e.g. create-realistic-images.

description
string
required

When to use the skill (its SKILL.md description).

version
string
required

SHA-256 of the skill's files in path order; changes with any file.

Pattern: ^[0-9a-f]{64}$
source
enum<string>
required

built-in: one of Spiral's reviewed skills; custom: your org's own.

Available options:
built-in,
custom
enabled
boolean
required

Whether your agents should load it: on unless your org turned it off (PATCH /v1/skills/{name}).

category
enum<string> | null
required

SKILL.md's category, one of the tool categories; null when it names none.

Available options:
llm,
image,
video,
3d,
audio,
web,
data,
social-media,
e-commerce,
finance,
lead-gen,
public-records,
listings,
maps-reviews,
seo,
news-media,
developer,
sports,
industry-data,
health
title
string | null
required

The skill's title: SKILL.md's first # heading (at most 120 characters); null when it has none.

capabilities
object[]
required

The tools its instructions call, each written as a code span provider/model, in order of first appearance.

files
object[]
required

Every file of the skill, in path order.