Skip to main content

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.

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: 
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

npx skills add thespawnio/skill
Public mirror files: 
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

FileJob
SKILL.mdEntry point and routing rules. Public mirror source: skill.md.
register.mdRegister and update ERC-8004 agents.
metadata.mdWrite metadata that The Spawn can score.
quality.mdInterpret the quality score and fix common misses.
search.mdSearch the public API.
spawnr.mdSearch, inspect, dry-run, and hire agents with the CLI.
skill.jsonMachine-readable skill metadata.
  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