agent-ready-x402 — Claude Code skill: what it does, how to install
agent-ready-x402 configures x402 payment protocol support for backend routes. Useful when your API needs to accept automated HTTP payments from AI agents.
Apache-2.0 ★ 141 updated 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-x402 -a claude-codeWhat agent-ready-x402 does
This skill guides coding agents through setting up agent-native HTTP payments with the x402 protocol. It helps inject middleware packages into Node.js services, specifically targeting @x402/express, @x402/hono, and @x402/next. Protected endpoints will answer with HTTP 402 Payment Required headers containing payment specs that caller agents handle automatically.
Setup depends on having both a facilitator URL and a destination crypto wallet address. Without those two values configured in the route middleware, payment requests will fail.
You can verify the configuration using the validation endpoint at https://isitagentready.com/api/scan. A passing setup reports pass under checks.commerce.x402.status.
What it helps with
- integrate the x402 payment protocol into API endpoints
- configure payment middleware for Express, Hono, or Next.js
- return HTTP 402 headers with machine-readable payment demands
- verify agent readiness through the isitagentready scan API
Example prompts for the agent
- Add
@x402/expressmiddleware to my API routes with my wallet address - Set up x402 protocol payments for our Next.js backend endpoints
- Check our domain readiness against the isitagentready scan endpoint
How to install agent-ready-x402
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-x402 -a claude-code2Manually: put the files in place
~/.claude/skills/x402/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/x402/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-x402 -a codex2Manually: put the files in place
.agents/skills/x402/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-x402 -a cursor2Manually: put the files in place
.cursor/skills/x402/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/x4022Manually: put the files in place
.github/skills/x402/SKILL.md1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-x402 -a gemini-cli2Platform CLI
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/x402Manually: put the files in place
.devin/skills/x402/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about agent-ready-x402
How do I install agent-ready-x402 in Claude Code?
Run npx skills add fabricioctelles/skills --skill x402 -a claude-code in your terminal.
What does agent-ready-x402 do?
It provides agent instructions to implement the x402 protocol, enabling automated micropayments on API routes via HTTP 402 status codes.
Which web frameworks does the skill support?
It covers middleware integration for @x402/express, @x402/hono, and @x402/next.
Source text
SKILL.md · Apache-2.0
---
name: agent-ready-x402
description: >
Sub-skill de agent-ready-cloudflare: Implement x402 Payment Protocol
---
# Implement x402 Payment Protocol
Support agent-native HTTP payments via the
[x402 protocol](https://x402.org)
([docs](https://docs.x402.org), [GitHub](https://github.com/coinbase/x402)).
## Requirements
- Add x402 payment middleware to your API routes
- Use `@x402/express`, `@x402/hono`, or `@x402/next` middleware
- Configure a facilitator URL and wallet address
- Protected routes return HTTP 402 with payment requirements that agents fulfill automatically
## Validate
```
POST https://isitagentready.com/api/scan
Content-Type: application/json
{"url": "https://YOUR-SITE.com"}
```
Check that `checks.commerce.x402.status` is `"pass"`.
© fabricioctelles · Apache-2.0 · fabricioctelles/skills