Etherscan Skills
Four Etherscan skills teach an agent to review contracts, transactions and money flows from live API data instead of model memory.
- 85 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The skills send addresses and hashes to the Etherscan API with your key and store investigation results on disk.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/etherscan-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skills send addresses and hashes to the Etherscan API with your key and store investigation results on disk.
This is third-party code. Review the repository files before installing.
What it does
The repository holds the `etherscan`, `etherscan-contract-review`, `etherscan-flow` and `etherscan-transaction-debugger` skills. The first helps pick the right Etherscan interface: website, API, command line or MCP. The second reviews verified EVM contracts: architecture, proxy roles, asset movement and privileged functions. The third builds a Flow Case JSON file with nodes and edges to trace money flows, including incidents. The fourth explains one or two transactions. Every address, amount and hash comes from a live API call and nothing is invented.
Who it is for. Smart contract auditors, on-chain analysts and developers who need a verifiable explanation of an EVM transaction or contract.
Good fit when
- You need to understand what a deployed contract does and who can control it.
- A transaction failed and the cause must be traced step by step.
- After an incident, a chain of transfers must be collected into one file.
- The agent needs guidance on which Etherscan interface suits the task.
Not a fit when
- The contract is not verified on Etherscan, so there is no source to review.
- You need a trading recommendation or a deal profitability estimate.
- The network is not supported by Etherscan API V2.
Example request
Analyze this transaction by hash, show where it failed and attach links to the Etherscan data behind the conclusion.Limitations
The skills only read data and do not sign transactions. Live calls need Etherscan API access, and terms and limits are set by the service. A contract can be reviewed in detail only when its source is verified. Conclusions about vulnerabilities and losses remain hypotheses with a stated confidence level: this is not an audit or a legal opinion. Caches and investigation results are stored locally, so do not leave private information in them.
How to disable. Remove the `etherscan`, `etherscan-contract-review`, `etherscan-flow` and `etherscan-transaction-debugger` folders from the agent skills directory. Delete Flow Case files and reports separately.
FAQ
How do I install a single skill?
Add the `--skill` flag, for example `npx skills add etherscan/skills --skill etherscan-contract-review`.
Can I skip npm?
Yes. A skill is a folder with `SKILL.md`: clone the repository and copy the folder you need into `~/.claude/skills/`.
What does `etherscan-flow` produce?
A single Flow Case JSON file with nodes and edges. Strict trace mode suits a transaction or address, business mode suits income, spending and treasury questions.
Where do amounts and addresses come from?
From live Etherscan API responses. The skills forbid inventing values.
Is this an official Etherscan repository?
Yes, it lives in the `etherscan` organization on GitHub.
Discussion
No questions or reviews yet.
Related
SkillsAn MCP server for EVM networks: an agent reads blocks, balances and contracts, fetches ABIs from Etherscan and signs transactions with a key
Skills for crypto agents: wallets, token swaps, onchain data and protocols such as Uniswap, Base, Alchemy and Zerion, each installed on its own
68 skills for crypto and DeFi: market APIs, on-chain analysis, backtests, position sizing, liquidity pools and trade taxes
Ten OKX exchange skills for prices, orders, portfolio, grid and DCA bots, earn products and sentiment via the okx CLI
MCP server that reads Elysium blocks, balances and contracts; signing is switched on by a flag and accepts the testnet only.
A skill that writes a nine-chapter report on a US, Hong Kong or China stock: reverse DCF, EPV, earnings-quality review and scripted valuation
README in short
A set of four Agent Skills for working with Etherscan and on-chain data. Each skill installs on its own and a `validate_skills.py` check script is in the repository.