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.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/etherscan--skills)HTML
<a href="/listings/etherscan--skills"><img src="/api/listings/etherscan--skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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-contract-review 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-contract-review only cp -r etherscan-skills/skills/etherscan-contract-review ~/.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-contract-review 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.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 109 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Etherscan Skills
- [Agent Skills](https://skills.sh) for working with [Etherscan](https://etherscan.io) 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.
- <!-- Badge row 1 - status -->
- [](https://github.com/etherscan/skills/graphs/contributors)
- [](https://github.com/etherscan/skills/graphs/contributors)
- 
- <!-- Badge row 2 - links and profiles -->
- [](https://etherscan.io)
- [](https://docs.etherscan.io/)
- [](https://twitter.com/etherscan)
- <!-- Badge row 3 - detailed status -->
- [](https://github.com/etherscan/skills/pulls)
- [](https://github.com/etherscan/skills/issues)
- ## Skills
- | Skill | Install | Description |
- | ----- | ------- | ----------- |
- | [etherscan](./skills/etherscan/SKILL.md) | `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-contract-review](./skills/etherscan-contract-review/SKILL.md) | `npx skills add etherscan/skills --skill etherscan-contract-review` | Review and explain verified deployed EVM contracts, including architecture, user and admin flows, proxy roles, asset movement, privileged controls, and evidence-backed uncertainty. |
- | [etherscan-flow](./skills/etherscan-flow/SKILL.md) | `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](./skills/etherscan-transaction-debugger/SKILL.md) | `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:
- ```bash
- npx skills add etherscan/skills
- ```
- Or install a single skill:
- ```bash
- npx skills add etherscan/skills --skill etherscan
- npx skills add etherscan/skills --skill etherscan-contract-review
- 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/`):
- ```bash
- git clone https://github.com/etherscan/skills.git etherscan-skills
- # Install etherscan only
- cp -r etherscan-skills/skills/etherscan ~/.claude/skills/
- # Install etherscan-contract-review only
- cp -r etherscan-skills/skills/etherscan-contract-review ~/.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-contract-review 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:**
- ```text
- Trace this transaction: 0x...
- ```
- ```text
- Follow the money from this address
- ```
- ```text
- Build a case for this scam
- ```
- ```text
- 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](CONTRIBUTING.md) for details.
- ## Security
- To report a vulnerability, see [SECURITY.md](SECURITY.md).
- ## License
- Licensed under the terms of the [LICENSE](LICENSE) file (MIT).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.