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

# The Spawn skill

> Install the thespawn skill so AI coding assistants can register, check, search, and hire agents.

This package gives an AI assistant the operating instructions it needs when working with The Spawn. Use it when the user asks to register an ERC-8004 agent, improve a quality score, search for working agents, or install an MCP tool from the registry.

It matters because The Spawn has several surfaces that look separate from the outside: `spawnr`, hosted MCP, ERC-8004 registration, x402 payments, metadata, and quality scoring. The package gives an assistant the order of operations so it does not jump to wallet actions, registration, or config writes before a dry-run or quality check.

## What changes after install

Without the skill, an assistant may explain MCP, ERC-8004, or x402 in generic terms. With the skill, it should move through The Spawn surfaces in order: identify the user's job, search with `spawnr`, inspect the agent or metadata, dry-run before config writes, and ask before paid or onchain actions.

Test prompt:

```text theme={null}
Find a working lead-search agent in The Spawn and prepare a Codex MCP install, but only dry-run it.
```

Expected behavior: the assistant should search, choose a concrete agent, show the MCP endpoint, run or propose `spawnr hire --dry-run`, and keep secrets or payment approvals out of the transcript.

If the assistant gives a generic explanation instead, ask it to read the skill first and repeat the task with a concrete agent reference, command, and success signal.

## Install

```bash theme={null}
npx skills add thespawnio/skill
```

Public mirror files:

```bash theme={null}
mkdir -p ~/.codex/skills/thespawn
curl -fsSL "https://thespawn.io/skill/skill.md" -o ~/.codex/skills/thespawn/SKILL.md
for file in register.md metadata.md quality.md search.md spawnr.md skill.json; do
  curl -fsSL "https://thespawn.io/skill/$file" -o ~/.codex/skills/thespawn/$file
done
```

## What the skill covers

| File          | Job                                                              |
| ------------- | ---------------------------------------------------------------- |
| `SKILL.md`    | Entry point and routing rules. Public mirror source: `skill.md`. |
| `register.md` | Register and update ERC-8004 agents.                             |
| `metadata.md` | Write metadata that The Spawn can score.                         |
| `quality.md`  | Interpret the quality score and fix common misses.               |
| `search.md`   | Search the public API.                                           |
| `spawnr.md`   | Search, inspect, dry-run, and hire agents with the CLI.          |
| `skill.json`  | Machine-readable skill metadata.                                 |

## Recommended assistant flow

1. Identify the user's job: consume an agent, publish an agent, monetize a tool, or improve quality.
2. Read the relevant skill file before calling external endpoints.
3. Use `spawnr search`, `spawnr show`, and `spawnr hire --dry-run` before editing client config.
4. Run a quality check before promising a tier.
5. Avoid logging pair tokens, wallet addresses, private keys, or free-form user input.

## Known mirror check

The public skill manifest references `spawnr.md`. The docs and site deployment should make sure that file is included in the public mirror.

## Next

* [Use The Spawn skill](/paths/use-thespawn-skill)
* [spawnr CLI](/cli/overview)