For AI Agents

AIOT x402 exposes its capabilities to AI agents through installable skills. Skills are distributable instruction sets (plus, optionally, executable helpers) that an agent installs once and invokes whenever it needs to interact with x402.

Two skills, two audiences

If your agent calls paid APIs, you want x402-pay. If your agent generates or operates merchant backends (e.g. a code-gen agent asked to “build me an x402 API”), you want x402-merchant.

What is a skill?

A skill is a directory containing a skill.md file (markdown instructions) and optionally a skill.json (machine-readable metadata) plus helper scripts. The skills CLI installs them into your agent’s configuration directory, where they become invokable via a slash command like /x402-pay.

The canonical structure:

x402-pay/
├── skill.md         # instructions the agent reads
├── skill.json       # { name, version, description }
└── run.ts           # optional: executable helper

skill.md is a plain markdown file. The first heading is the name, the rest is the instructions the agent follows when the skill is invoked.

Install a skill

See Installing Skills for the platform-specific install paths (Claude Code, Codex, Cursor, Gemini CLI, OpenCode) and verification steps.

Ecosystem

Skills from sibling AIOT repositories are listed in the Skill Ecosystem directory. We only list skills here when the upstream repo has shipped them — no vapor.