8004skill
The AI Agent Skill for the On-Chain Agent Economy
v2.3.0Register, discover, and rate AI agents across EVM chains.
Conversational. No CLI flags. Just talk.
How It Works
8004skill is a conversational skill for AI coding agents. Once installed, the agent reads the skill definition and guides you through every operation as an interactive wizard.
Example Prompts
15 Core Operations
Everything you need to manage AI agents on-chain, through natural conversation.
Configure
Set up chain, RPC, and WalletConnect session. IPFS uses env-backed credentials when needed.
Register
Create and register a new on-chain agent identity as an ERC-721 NFT
Search
Discover agents using semantic search or structured filters across chains
Load
Retrieve and display detailed information about any registered agent
Feedback
Submit on-chain reputation feedback with ratings, tags, and text
Inspect
View agent reputation, trust labels, endpoints, and connection details
Wallet
Set, get, or unset an agent's on-chain wallet. Signing via WalletConnect.
Verify
Prove or verify agent identity using cryptographic signatures
Whoami
Resolve your agent from config or wallet and show identity, status, trust, and endpoints
Transfer Agent
Transfer agent ownership to a new address. Irreversible.
Get Summary
Fetch the indexed AgentSummary view of any agent from the subgraph
Ownership
Check who owns an agent or verify if a specific address is the owner
SDK Diagnostics
Inspect registry addresses, read-only status, and chain/IPFS/subgraph availability
A2A Messaging
Send messages to agents, manage tasks, and handle A2A workflows with built-in x402 payment support.
X402 Payment
Execute HTTP requests with automatic x402 payment handling — approve amounts, pay, and receive responses.
Supported Chains
Powered by agent0 SDK. Built-in defaults for 5 chains, plus additional deployed mainnets with manual config.
Full SDK Support (Ready to Use)
Deployed Mainnets (Manual Config)
Contracts deployed with the same CREATE2 addresses. Discovery flows require SUBGRAPH_URL on non-default chains.
Secure by Design
WalletConnect v2 signing model. Your keys never leave your device.
WalletConnect Secure Signing
Primary signing uses WalletConnect v2 — signing happens in your wallet app. PRIVATE_KEY in ~/.8004skill/.env is available as an optional headless alternative for x402 payments and automated workflows.
Per-Transaction Approval
Every on-chain transaction requires explicit approval in your wallet app. Nothing is auto-signed.
Session File Security
WalletConnect session files contain no key material. Protected with chmod 600, symlink attack prevention, and cloud-sync detection.
Minimal Secret Exposure
Config stores chain, RPC, IPFS provider, WalletConnect ID, and registration metadata — no secrets. ~/.8004skill/.env optionally holds PRIVATE_KEY for headless signing, protected with chmod 600.
Untrusted Data Protection
On-chain agent data is treated as untrusted external content. Prompt-injection payloads in names, descriptions, or metadata are flagged and rendered safely — never executed.
Quick Start
Three steps to get started. No CLI flags to memorize.
# Step 1: Install the skill
$ npx skills add matteoscurati/8004skill -g
# Step 2: Configure your chain
> "Configure 8004 for Sepolia"
# Step 3: Start using it
> "Register my agent on-chain"
> "Search for agents that do summarization"
> "Give feedback to agent 11155111:42"
Requires Node.js ≥ 22.0.0 · Compatible with Claude Code, Cursor, Codex, and 35+ more agents