# erc-8004

Registers an AI agent identity on Ethereum using the ERC-8004 standard. Useful for issuing an agent NFT, linking metadata, and joining on-chain reputation registries.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 232 installs · ★ 1216 repo stars
- Author: BankrBot
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/BankrBot/skills/tree/HEAD/erc-8004/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/erc-8004

## What it does

This skill helps an agent claim an on-chain identity under the ERC-8004 specification. The process assigns an ERC-721 token in Ethereum Mainnet or the Sepolia testnet. The profile links an avatar, endpoints, and protocol details like A2A communication.

Metadata can live on IPFS, an HTTP server, or directly on-chain as a base64 Data URI. The repository supplies shell scripts for publishing metadata via Pinata, updating profiles, and bridging ETH from Base to Mainnet. Developers can also manage entries with the `agent0-sdk` package in TypeScript.

On-chain transactions consume roughly 100-200k gas. Registration fails immediately if your deployment wallet lacks native ETH for mainnet gas fees.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add BankrBot/skills --skill erc-8004 -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/erc-8004/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/erc-8004/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add BankrBot/skills --skill erc-8004 -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/erc-8004/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add BankrBot/skills --skill erc-8004 -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/erc-8004/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install BankrBot/skills erc-8004
```

2. **Manually: put the files in place**
- File: `.github/skills/erc-8004/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add BankrBot/skills --skill erc-8004 -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/BankrBot/skills --path erc-8004
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/erc-8004/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add BankrBot/skills --skill erc-8004 -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/BankrBot/skills/tree/HEAD/erc-8004/SKILL.md

## When to use it
- register an agent identity token in the ERC-8004 contract
- mint an ERC-721 agent profile on Ethereum Mainnet or Sepolia
- publish registration metadata to IPFS with Pinata
- bridge ETH from Base to Mainnet for gas coverage

## Example prompts
- Register my AI agent on Ethereum using `register.sh`
- Bridge 0.01 ETH from Base to Ethereum mainnet for gas fees
- Update the metadata IPFS URI for agent ID 123

## Similar
- [ERC-8126 Scan](https://affpapa.org/en/nevibecode/mcp/erc-8126-scan.md) — MCP server
- [blockchain-expert](https://affpapa.org/en/nevibecode/skills/blockchain-expert.md) — skill · 296 installs
- [ethskills](https://affpapa.org/en/nevibecode/skills/ethskills.md) — skill · 2500 installs
- [ERC-8004 Agent Identity Bridge](https://affpapa.org/en/nevibecode/mcp/erc-8004-agent-identity-bridge.md) — MCP server · 555 installs
- [abstract](https://affpapa.org/en/nevibecode/skills/abstract.md) — skill · 259 installs
- [RNWY Trust Intelligence | AI Scanner](https://affpapa.org/en/nevibecode/mcp/rnwy-trust-intelligence-ai-scanner.md) — MCP server · 2336 installs

From the same set: [bankrbot/skills](https://affpapa.org/en/nevibecode/by/bankrbot/skills.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
