Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/etherscan--skills/badge.svg)](/listings/etherscan--skills)

HTML

<a href="/listings/etherscan--skills"><img src="/api/listings/etherscan--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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)

  1. # Etherscan Skills
  2. [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.
  3. <!-- Badge row 1 - status -->
  4. [![GitHub contributors](https://img.shields.io/github/contributors/etherscan/skills)](https://github.com/etherscan/skills/graphs/contributors)
  5. [![GitHub commit activity](https://img.shields.io/github/commit-activity/w/etherscan/skills)](https://github.com/etherscan/skills/graphs/contributors)
  6. ![GitHub repo size](https://img.shields.io/github/repo-size/etherscan/skills)
  7. <!-- Badge row 2 - links and profiles -->
  8. [![Website etherscan.io](https://img.shields.io/website-up-down-green-red/https/etherscan.io.svg)](https://etherscan.io)
  9. [![Docs](https://img.shields.io/badge/docs-up-green)](https://docs.etherscan.io/)
  10. [![Twitter Etherscan](https://img.shields.io/twitter/follow/etherscan?style=social)](https://twitter.com/etherscan)
  11. <!-- Badge row 3 - detailed status -->
  12. [![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/etherscan/skills)](https://github.com/etherscan/skills/pulls)
  13. [![GitHub Issues](https://img.shields.io/github/issues-raw/etherscan/skills.svg)](https://github.com/etherscan/skills/issues)
  14. ## Skills
  15. | Skill | Install | Description |
  16. | ----- | ------- | ----------- |
  17. | [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. |
  18. | [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. |
  19. | [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. |
  20. | [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. |
  21. ## Installation
  22. ### With the Skills CLI
  23. Install every skill in this repo:
  24. ```bash
  25. npx skills add etherscan/skills
  26. ```
  27. Or install a single skill:
  28. ```bash
  29. npx skills add etherscan/skills --skill etherscan
  30. npx skills add etherscan/skills --skill etherscan-contract-review
  31. npx skills add etherscan/skills --skill etherscan-flow
  32. npx skills add etherscan/skills --skill etherscan-transaction-debugger
  33. ```
  34. ### Without npm
  35. A skill is just a folder with a `SKILL.md` — no package manager required.
  36. **Copy the folder** into your agent's skills directory (e.g. `~/.claude/skills/`):
  37. ```bash
  38. git clone https://github.com/etherscan/skills.git etherscan-skills
  39. # Install etherscan only
  40. cp -r etherscan-skills/skills/etherscan ~/.claude/skills/
  41. # Install etherscan-contract-review only
  42. cp -r etherscan-skills/skills/etherscan-contract-review ~/.claude/skills/
  43. # Install etherscan-flow only
  44. cp -r etherscan-skills/skills/etherscan-flow ~/.claude/skills/
  45. # Install etherscan-transaction-debugger only
  46. cp -r etherscan-skills/skills/etherscan-transaction-debugger ~/.claude/skills/
  47. # Install all skills
  48. 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/
  49. ```
  50. **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.
  51. ## Usage
  52. Skills are available to your agent as soon as they're installed. The agent uses them automatically when a relevant task shows up.
  53. **Examples:**
  54. ```text
  55. Trace this transaction: 0x...
  56. ```
  57. ```text
  58. Follow the money from this address
  59. ```
  60. ```text
  61. Build a case for this scam
  62. ```
  63. ```text
  64. Show ENS DAO's income and spending as a business
  65. ```
  66. ## Contributing
  67. New skills go in `skills/<name>/` with a `SKILL.md` at the folder root. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
  68. ## Security
  69. To report a vulnerability, see [SECURITY.md](SECURITY.md).
  70. ## License
  71. Licensed under the terms of the [LICENSE](LICENSE) file (MIT).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.