Platform-wide skill catalog (read-only on v1)

List every published skill. Unscoped by tenant — same catalog for every caller…

GET /api/v1/skills

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/skills' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

[
  {
    "key": "string",
    "display_name": "Ada Lovelace",
    "description": "Two-person tent, green — replacement for damaged pole set.",
    "container_type": "string",
    "container_version": "latest",
    "triggers": [
      "string"
    ],
    "tags": [
      "priority"
    ],
    "created_at": "2026-08-31T14:22:05Z",
    "updated_at": "2026-08-31T14:22:05Z"
  }
]

List every published skill. Unscoped by tenant — same catalog for every caller. Sorted alphabetically by key for stable cursoring on SDK clients that paginate locally.

To attach a skill to a custom agent, copy its key into the custom agent’s skills array (see POST /api/v1/custom-agents).

Response

SkillSummary[] — each element:

key · string · required

Stable lookup id; immutable once published.

display_name · string · required

Human-readable name for SDK / UI surfaces.

description · string · required

What this skill does, ≤1024 chars.

container_type · string,null

Container/runtime hint, when applicable (e.g. ‘docker’, ‘lambda’). None for generic / inline skills.

container_version · string

Version label for the underlying container image.

triggers · string[]

Activation triggers (e.g. ‘manual’, ‘on-tool-call’).

tags · string[]

Categorization tags (e.g. ‘finance’, ‘compliance’).

created_at · string · required

updated_at · string · required

Status codes

Code	Meaning
200	Successful Response

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/skills' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

[
  {
    "key": "string",
    "display_name": "Ada Lovelace",
    "description": "Two-person tent, green — replacement for damaged pole set.",
    "container_type": "string",
    "container_version": "latest",
    "triggers": [
      "string"
    ],
    "tags": [
      "priority"
    ],
    "created_at": "2026-08-31T14:22:05Z",
    "updated_at": "2026-08-31T14:22:05Z"
  }
]