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

# Skills

> Find, install, and run agent skills that pay for x402 services through SELAT.

A **skill** is a declarative manifest of one or more catalogue endpoint steps. Running a skill pays for each step through SELAT, so an agent can complete a paid task without hand-building a client.

Manifests are **data, not code** — installing a skill only ever writes a manifest to disk; it never runs arbitrary code. Skills come from the public [selat-skills](https://github.com/SELAT-AI/selat-skills) registry or from a local path.

You manage skills with the [SELAT CLI](/docs/selat-cli)'s `selat skill` subcommands. To author and publish your own, see [Authoring and publishing](/docs/skills/authoring-and-publishing).

## Find a skill

List what's available in the registry, with a live reliability badge for each (● ok · ● degraded · ● down · ○ unknown):

```bash theme={null}
selat skill list --available
```

The badge is refreshed on a six-hour schedule from a free live 402 probe (no signature, no payment). List the skills already installed locally:

```bash theme={null}
selat skill list
```

## Install a skill

By name from the registry, or from a local path:

```bash theme={null}
selat skill install market-snapshot
selat skill install ./path/to/skill        # from disk
```

## Run a skill

Pass the skill's manifest parameters as `--flags` (manifest keys map 1:1, no renaming):

```bash theme={null}
selat skill run token-price --symbols ETH,USDC
```

Three reserved flags override payment behavior on every step:

| Override             | Description                                                                                                                       |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `--chain <key>`      | Settle on a specific chain (see [signer and chain guidance](/docs/selat-sdk/router-client#select-a-signer-and-chain)).                 |
| `--max-amount <usd>` | Cap the price paid per step.                                                                                                      |
| `--raw-key`          | Sign locally with `SELAT_PRIVATE_KEY` instead of the Circle Agent Wallet. Required for chains Circle's MPC signer can't sign yet. |

```bash theme={null}
selat skill run web-search --query "USDC news" --chain arc
```

Each step prints its rail and price as it runs, followed by a per-step summary so a multi-rail run reports every rail even if one step fails.

## Related docs

* [Authoring and publishing](/docs/skills/authoring-and-publishing)
* [SELAT CLI](/docs/selat-cli)
* [SELAT Router](/docs/router)