Agent skill

Erc 8004

by aAAaqwq in aAAaqwq/AGI-Super-Team

Register AI agents on Ethereum mainnet using ERC-8004 (Trustless Agents).

MITAuto-check passedBackend & APIs

Install Erc 8004

skills CLI
$ npx skills add aAAaqwq/AGI-Super-Team --skill erc-8004 -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aAAaqwq/AGI-Super-Team erc-8004 --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aAAaqwq/AGI-Super-Team.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/erc-8004 .claude/skills/erc-8004 && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
erc-8004
GitHub stars
105
Used in
2 other repos
Token cost
~1.2k tokens
SKILL.md length
297 words
Files
10 (incl. scripts, references)
Skills in repo
167
Repo updated
First seen
Licence
MIT

At a glance

Register AI agents on Ethereum mainnet using ERC-8004 (Trustless Agents).

  • Works in 3 steps: Register Your Agent → Bridge ETH to Mainnet (if needed) → Update Agent Profile
  • The user wants to register their agent identity on-chain
  • SKILL.md covers What is ERC-8004?, Contract Addresses, Quick Start and Environment Variables, plus 6 more sections
  • Runs Shell scripts from its folder; calls npm; reaches eips.ethereum.org and image.url; needs PRIVATE_KEY

What it does

Erc 8004 is an agent skill from aAAaqwq/AGI-Super-Team. Register AI agents on Ethereum mainnet using ERC-8004 (Trustless Agents). Use when the user wants to register their agent identity on-chain, create an agent profile, claim an agent NFT, set up agent reputation, or make their agent discoverable. Handles bridging ETH to mainnet, IPFS upload, and on-chain registration.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `references/erc-8004-spec.md`, `scripts/bridge-to-mainnet.sh` and `scripts/create-registration.sh`).

It sits in Backend & APIs, covering Smart contracts and Crypto and DeFi analysis. It works with Ethereum. The repository describes itself as: An installable, cross-framework AI organization: C-suite agents, expert subagents, curated skills, independent review, and one-command setup across 18 AI client/runtime adapters. The licence is MIT.

When your agent uses it

  • The user wants to register their agent identity on-chain
  • Create an agent profile
  • Claim an agent NFT
  • Set up agent reputation

Example prompts

  • “/erc-8004”

Requirements

  • Node.js
  • A Bash shell
  • A credential in PRIVATE_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Register Your Agent
  2. Bridge ETH to Mainnet (if needed)
  3. Update Agent Profile

What it can do on your machine

Read from SKILL.md and the folder at commit 7cefd81. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 8 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • eips.ethereum.org
    • image.url

    Also links to:

    • 8004.org
    • github.com
    • sdk.ag0.xyz

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • PRIVATE_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Erc 8004 loads about 1.2k tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 82 tokens; SKILL.md has 297 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~82
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aAAaqwq/AGI-Super-Team at commit 7cefd81, republished under its MIT licence (© aAAaqwq). 297 words, ~1,208 tokens.

Download SKILL.mdSave it as .claude/skills/erc-8004/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
erc-8004
description
Register AI agents on Ethereum mainnet using ERC-8004 (Trustless Agents). Use when the user wants to register their agent identity on-chain, create an agent profile, claim an agent NFT, set up agent reputation, or make their agent discoverable. Handles bridging ETH to mainnet, IPFS upload, and on-chain registration.

ERC-8004: Trustless Agents

Register your AI agent on Ethereum mainnet with a verifiable on-chain identity, making it discoverable and enabling trust signals.

What is ERC-8004?

ERC-8004 is an Ethereum standard for trustless agent identity and reputation:

  • Identity Registry - ERC-721 based agent IDs (your agent gets an NFT!)
  • Reputation Registry - Feedback and trust signals from other agents/users
  • Validation Registry - Third-party verification of agent work

Website: https://www.8004.org Spec: https://eips.ethereum.org/EIPS/eip-8004

Contract Addresses

ChainIdentity RegistryReputation Registry
Ethereum Mainnet0x8004A169FB4a3325136EB29fA0ceB6D2e539a4320x8004BAa17C55a88189AE136b182e5fdA19dE9b63
Sepolia Testnet0x8004A818BFB912233c491871b3d84c89A494BD9e0x8004B663056A597Dffe9eCcC1965A193B7388713

Quick Start

1. Register Your Agent
bash
# Full registration (creates profile, uploads to IPFS, registers on-chain)
./scripts/register.sh

# Or with custom values
NAME="My Agent" \
DESCRIPTION="An AI agent that does cool stuff" \
IMAGE="https://example.com/avatar.png" \
./scripts/register.sh
2. Bridge ETH to Mainnet (if needed)
bash
# Bridge ETH from Base to Ethereum mainnet
./scripts/bridge-to-mainnet.sh 0.01
3. Update Agent Profile
bash
# Update your agent's registration file
./scripts/update-profile.sh <agent-id> <new-ipfs-uri>

Environment Variables

VariableDescriptionRequired
PINATA_JWTPinata API JWT for IPFS uploadsNo (only for IPFS)
AGENT_NAMEAgent display nameNo (defaults to wallet ENS or address)
AGENT_DESCRIPTIONAgent descriptionNo
AGENT_IMAGEAvatar URLNo

Registration Options

Option 1: Use 8004.org frontend (easiest) Visit https://www.8004.org and register through the UI — handles IPFS automatically.

Option 2: HTTP URL (no IPFS needed) Host your registration JSON at any URL:

bash
REGISTRATION_URL="https://myagent.xyz/agent.json" ./scripts/register-http.sh

Option 3: IPFS via Pinata

bash
PINATA_JWT="your-jwt" ./scripts/register.sh

Option 4: Data URI (fully on-chain) Encode your registration as base64 — no external hosting needed:

bash
./scripts/register-onchain.sh

Registration File Format

Your agent's registration file (stored on IPFS) follows this structure:

json
{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "My Agent",
  "description": "An AI assistant for various tasks",
  "image": "https://example.com/avatar.png",
  "services": [
    {
      "name": "web",
      "endpoint": "https://myagent.xyz/"
    },
    {
      "name": "A2A",
      "endpoint": "https://myagent.xyz/.well-known/agent-card.json",
      "version": "0.3.0"
    }
  ],
  "x402Support": false,
  "active": true,
  "registrations": [
    {
      "agentId": 123,
      "agentRegistry": "eip155:1:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432"
    }
  ],
  "supportedTrust": ["reputation"]
}

Workflow

  1. Bridge ETH (if needed) - Use Bankr to bridge ETH from Base/L2 to mainnet
  2. Create Profile - Generate a registration JSON file with agent info
  3. Upload to IPFS - Pin the file via Pinata (or other provider)
  4. Register On-Chain - Call register(agentURI) on the Identity Registry
  5. Update Profile - Set metadata, wallet, or update URI as needed

Costs

  • Gas: 100-200k gas for registration ($5-20 depending on gas prices)
  • IPFS: Free tier available on Pinata (1GB)

Using the SDK

For more advanced usage, install the Agent0 SDK:

bash
npm install agent0-sdk
typescript
import { SDK } from 'agent0-sdk';

const sdk = new SDK({
  chainId: 1, // Ethereum Mainnet
  rpcUrl: process.env.ETH_RPC_URL,
  privateKey: process.env.PRIVATE_KEY,
  ipfs: 'pinata',
  pinataJwt: process.env.PINATA_JWT
});

const agent = sdk.createAgent('My Agent', 'Description', 'https://image.url');
const result = await agent.registerIPFS();
console.log(`Registered: Agent ID ${result.agentId}`);

© aAAaqwq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (scripts, references) in skills/erc-8004 of aAAaqwq/AGI-Super-Team.

  • SKILL.md
  • references/erc-8004-spec.md
  • scripts/bridge-to-mainnet.sh
  • scripts/create-registration.sh
  • scripts/get-agent.sh
  • scripts/register-http.sh
  • scripts/register-onchain.sh
  • scripts/register.sh
  • scripts/update-profile.sh
  • scripts/upload-to-ipfs.sh

Open the folder on GitHubat commit 7cefd81

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in aAAaqwq/AGI-Super-Team, which our catalogue first saw on October 9, 2026.

Compare with similar skills

Erc 8004 next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Erc 8004 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Erc 8004 this skillaAAaqwq/AGI-Super-Team1052 repos~1.2kAutomated safety check: PassMIT
Ethskillsaustintgriffith/ethskills295—~1.4kAutomated safety check: PassNone
Payram Crypto PaymentsPayRam/payram-mcp158—~2kAutomated safety check: NotesNone
Use Arccirclefin/skills155—~2.1kAutomated safety check: NotesApache-2.0
Use Usdccirclefin/skills155—~2.4kAutomated safety check: NotesApache-2.0
Ethskillsaustintgriffith/ethskills295—~3kAutomated safety check: PassNone

Similar skills

  • Ethskills

    austintgriffith/ethskills

    Ethereum development knowledge for AI agents — from idea to deployed dApp.

    295 GitHub stars~1.4k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Payram Crypto Payments

    PayRam/payram-mcp

    Self-hosted crypto and stablecoin payment gateway. An agent skill from PayRam/payram-mcp.

    158 GitHub stars~2k tokensUpdated 3 days ago
    Backend & APIsAuto-check: notes
  • Use Arc

    circlefin/skills

    Provide instructions on how to build with Arc, Circle's blockchain where USDC is the native gas token.

    155 GitHub stars~2.1k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Use Usdc

    circlefin/skills

    USDC is Circle's stablecoin deployed across multiple blockchain ecosystems including EVM chains (Ethereum, Base, Arbitrum, Polygon, Arc) and Solana.

    155 GitHub stars~2.4k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Ethskills

    austintgriffith/ethskills

    A skill your agent uses when a request involves Ethereum, the EVM, or blockchain systems.

    295 GitHub stars~3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • A skill your agent uses when accessing Alchemy APIs for RPC calls, token balances, NFT metadata, asset transfers, transaction simulation, or Alchemy-specific features.

    113 GitHub stars~2.1k tokensUpdated 1 mo ago
    Backend & APIsAuto-check: notes

More from aAAaqwq/AGI-Super-Team

All 167 skills in this repo
  • Content Creator

    aAAaqwq/AGI-Super-Team

    Create SEO-optimized marketing content with consistent brand voice.

    105 GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • Financial Calculator

    aAAaqwq/AGI-Super-Team

    Advanced financial calculator with future value tables, present value, discount calculations, markup pricing, and compound interest.

    105 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Bankr Signals

    aAAaqwq/AGI-Super-Team

    Transaction-verified trading signals on Base blockchain. An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub starsUsed in 2 repos~3.3k tokens
    Auto-check passed
  • Frontend Design Ultimate

    aAAaqwq/AGI-Super-Team

    Create distinctive, production-grade static sites with React, Tailwind CSS, and shadcn/ui — no mockups needed.

    105 GitHub starsUsed in 2 repos~2.7k tokens
    Auto-check passed
  • Zsxq Smart Publish

    aAAaqwq/AGI-Super-Team

    Publish and manage content on 知识星球 (zsxq.com). An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Sysadmin Toolbox

    aAAaqwq/AGI-Super-Team

    Tool discovery and shell one-liner reference for sysadmin, DevOps, and security tasks.

    105 GitHub starsUsed in 2 repos~775 tokens
    Auto-check passed

Works with

Questions about Erc 8004

What does Erc 8004 do?

Register AI agents on Ethereum mainnet using ERC-8004 (Trustless Agents). Erc 8004 is an agent skill from aAAaqwq/AGI-Super-Team. Register AI agents on Ethereum mainnet using ERC-8004 (Trustless Agents).

When should I use Erc 8004?

Erc 8004 fits situations like: the user wants to register their agent identity on-chain; create an agent profile; claim an agent NFT; set up agent reputation.

How do I install Erc 8004 in Claude Code?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill erc-8004 -a claude-code`. Or copy the skill folder (skills/erc-8004 in aAAaqwq/AGI-Super-Team) into .claude/skills/erc-8004 in your project. Claude Code loads it when a task matches its description.

How do I install Erc 8004 in Codex?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill erc-8004 -a codex`. Or copy the skill folder (skills/erc-8004 in aAAaqwq/AGI-Super-Team) into .agents/skills/erc-8004 in your project. Codex loads it when a task matches its description.

Can I use Erc 8004 in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aAAaqwq/AGI-Super-Team --skill erc-8004 -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/erc-8004, .gemini/skills/erc-8004, .github/skills/erc-8004 and .opencode/skills/erc-8004 in your project.

What does Erc 8004 need to run?

Going by SKILL.md and its folder, Erc 8004 needs a shell for the scripts in its folder, the command-line tools its instructions call (npm) and credentials named PRIVATE_KEY. Our summary lists: Node.js; A Bash shell; A credential in PRIVATE_KEY.

Does Erc 8004 access the network?

SKILL.md names 5 domains. In commands or code: eips.ethereum.org and image.url; the agent is likely to contact these when it follows the instructions. As links in the text: 8004.org, github.com and sdk.ag0.xyz. This is read from the text; nothing was executed.

Is Erc 8004 safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Erc 8004 use?

Erc 8004 is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Erc 8004 use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.1k tokens, read only when the agent opens those files.

What are the alternatives to Erc 8004?

Skills that share tags, products or a category with Erc 8004: Ethskills (austintgriffith/ethskills, 295 stars), Payram Crypto Payments (PayRam/payram-mcp, 158 stars), Use Arc (circlefin/skills, 155 stars) and Use Usdc (circlefin/skills, 155 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Erc 8004?

aAAaqwq (a GitHub user) maintains it in aAAaqwq/AGI-Super-Team, which has 105 GitHub stars. The repository holds 167 skills in this directory. The repository was last updated on October 8, 2026.

Source: aAAaqwq/AGI-Super-Team on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.