Etherscan Skills

Agent Skills for working with Etherscan and on-chain data. These skills let AI agents turn raw Etherscan API responses into structured, verifiable output — every address, amount, and transaction hash comes from a live API call, never invented.

Skills

Skill	Install	Description
etherscan	npx skills add etherscan/skills --skill etherscan	Navigate Etherscan website features, API endpoints, CLI commands, and MCP tools, selecting the right interface and verifying current behavior from live official sources.
etherscan-flow	npx skills add etherscan/skills --skill etherscan-flow	Trace on-chain money flow via the Etherscan API V2 and write a single Etherscan Flow Case JSON file (nodes + edges). Two modes — strict trace for tx/address investigation, and business/entity profile for income, spending, and treasury questions. Security cases reconstruct an evidence-backed incident mechanism, confidence, and losses.
etherscan-transaction-debugger	npx skills add etherscan/skills --skill etherscan-transaction-debugger	Analyze and explain one or two EVM transactions from live Etherscan data, with human-verifiable evidence links. Reconstructs the supported execution path, decodes calls and events, summarizes asset and permission changes, and explains failures — with confidence ratings and stated limitations.

Installation

With the Skills CLI

Install every skill in this repo:

npx skills add etherscan/skills

Or install a single skill:

npx skills add etherscan/skills --skill etherscan
npx skills add etherscan/skills --skill etherscan-flow
npx skills add etherscan/skills --skill etherscan-transaction-debugger

Without npm

A skill is just a folder with a SKILL.md — no package manager required.

Copy the folder into your agent's skills directory (e.g. ~/.claude/skills/):

git clone https://github.com/etherscan/skills.git etherscan-skills

# Install etherscan only
cp -r etherscan-skills/skills/etherscan ~/.claude/skills/

# Install etherscan-flow only
cp -r etherscan-skills/skills/etherscan-flow ~/.claude/skills/

# Install etherscan-transaction-debugger only
cp -r etherscan-skills/skills/etherscan-transaction-debugger ~/.claude/skills/

# Install all skills
cp -r etherscan-skills/skills/etherscan etherscan-skills/skills/etherscan-flow etherscan-skills/skills/etherscan-transaction-debugger ~/.claude/skills/

Or download the ZIP from the green Code button on GitHub, unzip it, and copy any or all folders under skills/ into your skills directory. Copy each complete skill folder so that its SKILL.md remains at the folder root.

Usage

Skills are available to your agent as soon as they're installed. The agent uses them automatically when a relevant task shows up.

Examples:

Trace this transaction: 0x...

Follow the money from this address

Build a case for this scam

Show ENS DAO's income and spending as a business

Contributing

New skills go in skills/<name>/ with a SKILL.md at the folder root. See CONTRIBUTING.md for details.

Security

To report a vulnerability, see SECURITY.md.

License

Licensed under the terms of the LICENSE file (MIT).