> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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:

<ResponseField name="key" type="string" required>
  Stable lookup id; immutable once published.
</ResponseField>

<ResponseField name="display_name" type="string" required>
  Human-readable name for SDK / UI surfaces.
</ResponseField>

<ResponseField name="description" type="string" required>
  What this skill does, ≤1024 chars.
</ResponseField>

<ResponseField name="container_type" type="string,null">
  Container/runtime hint, when applicable (e.g. 'docker', 'lambda'). None for generic / inline skills.
</ResponseField>

<ResponseField name="container_version" type="string">
  Version label for the underlying container image.
</ResponseField>

<ResponseField name="triggers" type="string[]">
  Activation triggers (e.g. 'manual', 'on-tool-call').
</ResponseField>

<ResponseField name="tags" type="string[]">
  Categorization tags (e.g. 'finance', 'compliance').
</ResponseField>

<ResponseField name="created_at" type="string" required />

<ResponseField name="updated_at" type="string" required />

### Status codes

| Code  | Meaning             |
| ----- | ------------------- |
| `200` | Successful Response |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.computer.stateset.app/api/v1/skills' \
    --header 'X-API-Key: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "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"
    }
  ]
  ```
</ResponseExample>