
Evm Audit Master
- 4 installs
- 9 repo stars
- Updated July 9, 2026
- austintgriffith/evm-audit-skills
evm-audit-master is a Claude skill that acts as the master routing index and methodology for a suite of EVM smart-contract security audit skills.
About
This skill is the master index for a set of EVM smart-contract security audit skills. An auditor loads it first for every audit to determine which specialized skills to load, using its routing table and methodology. It indexes 20 skills covering topics from ERC-20 quirks to proxies, oracles, and flash loans.
- Master index and routing table for 20 EVM smart-contract security audit skills
- Defines the audit methodology: load master first, read contracts, load relevant specialized skills
- Routes to specialized checklists (ERC20, DeFi, proxies, oracles, signatures, bridges)
Evm Audit Master by the numbers
- 4 all-time installs (skills.sh)
- Ranked #1,741 of 2,203 Security skills by installs in the Skillselion catalog
- Data as of Jul 28, 2026 (Skillselion catalog sync)
evm-audit-master capabilities & compatibility
- Capabilities
- security audit · smart contract audit · code review
- Use cases
- security audit · code review
- Pricing
- Free
What evm-audit-master says it does
Master index for EVM smart contract security audit skills. Load this FIRST for every audit to determine which specialized skills to load.
Use the routing table below to load relevant specialized skills
npx skills add https://github.com/austintgriffith/evm-audit-skills --skill evm-audit-masterAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 4 |
|---|---|
| repo stars | ★ 9 |
| Last updated | July 9, 2026 |
| Repository | austintgriffith/evm-audit-skills ↗ |
What it does
Route an EVM smart-contract audit to the right specialized security checklists and run them systematically.
Who is it for?
Auditors starting an EVM smart-contract security review
When should I use this skill?
beginning any EVM smart contract audit to decide which specialized skills to load
What you get
A routed audit plan with the relevant specialized skills loaded and their checklists worked through.
By the numbers
- indexes 20 specialized audit skills
- sub-skills carry item counts such as 46+, 42+, and 33+ patterns
Files
EVM Smart Contract Security Audit — Master Index
How To Use
1. Always load this skill first for any EVM smart contract audit 2. Read the contract(s) under audit 3. Use the routing table below to load relevant specialized skills 4. Walk through each loaded skill's checklist systematically
All 20 Skills — Definitive Index
| # | Skill | Description | Items |
|---|---|---|---|
| 1 | evm-audit-master | This file. Routing table, methodology, source attribution. Load first. | — |
| 2 | evm-audit-general | Cross-cutting issues: storage pointers, struct deletion, mixed accounting, merkle proofs, msg.value in loops, try/catch, delegatecall, upgrades, downcasting, rebasing tokens, fee-on-transfer, ERC4626 inflation attack | 46+ |
| 3 | evm-audit-precision-math | Division-before-multiplication, rounding to zero, precision scaling mismatches, downcast overflow, rounding direction (protocol vs user), decimal assumption errors | 23+ |
| 4 | evm-audit-erc20 | Fee-on-transfer, rebasing, ERC777 hooks, approve race conditions, zero-transfer reverts, pausable tokens, deny lists (USDC), deflationary/inflationary tokens, multiple-address tokens | 27+ |
| 5 | evm-audit-defi-amm | AMM/DEX slippage attacks, CLM vulnerabilities (TWAP bypass, sandwich via owner functions, stuck tokens, stale approvals, retrospective fees), UniswapV3/V4 hooks, fee tier issues | 30+ |
| 6 | evm-audit-defi-lending | Liquidation vulnerabilities (20+ patterns), lending/borrowing attacks, bad debt handling, partial liquidation bypasses, front-run prevention, collateral hiding, insurance fund edge cases, non-18 decimal failures | 33+ |
| 7 | evm-audit-defi-staking | Liquid staking, restaking, EigenLayer integration, stakedButUnverified accounting, Beacon Chain proof verification (Deneb), validator front-running, cooldown exploitation, reward calculation precision | 30+ |
| 8 | evm-audit-erc4626 | Share/asset conversion, inflation attack, virtual shares, deposit/withdraw rounding, first depositor attack, multi-step operations, 85+ patterns from Dacian's ERC4626 primer | 42+ |
| 9 | evm-audit-erc4337 | Account abstraction, smart wallet security, paymaster attacks, session key exploits, UserOperation validation, bundler trust assumptions, gas griefing | 18+ |
| 10 | evm-audit-bridges | Cross-chain bridge security, LayerZero V2, CCIP, Wormhole, Across, message replay, finality assumptions, relayer trust, adapter pattern issues | 32+ |
| 11 | evm-audit-proxies | UUPS deep dive (uninitialized implementation, delegatecall to selfdestruct, broken upgrade chain, authorization schema changes), Transparent proxy, Beacon, Diamond, storage collision, immutable variable loss | 18+ |
| 12 | evm-audit-signatures | Signature replay (missing nonce, cross-chain, missing parameter, no expiration), ecrecover return check, signature malleability, EIP-712 conformance, ECDSA library version requirements | 19+ |
| 13 | evm-audit-governance | DAO attacks (flash-loan + delegation bypass, voting power destruction, totalPower manipulation, snapshot staleness, quorum impossibility, treasury delegation abuse, restriction bypass, token recycling, proposal deadlines, pre-mint exploitation), proposal execution ordering, fake proposals via CREATE2, multi-sig quorum failure | 23+ |
| 14 | evm-audit-oracles | Chainlink integration (stale prices, L2 sequencer, per-feed heartbeats, decimal assumptions, wrong addresses, front-running, unhandled reverts, depeg detection, minAnswer/maxAnswer), Sigma Prime patterns (spot price manipulation, homegrown oracle risks, gas congestion, hardcoded pegs, TWAP limitations) | 29+ |
| 15 | evm-audit-assembly | Inline assembly memory corruption (external call overwrites, stale FMPA assumptions, insufficient allocation), call to non-existent contracts, overflow/underflow without protection, uint128 overflow evading 256-bit detection | 27+ |
| 16 | evm-audit-chain-specific | L2/alt-chain quirks — Arbitrum, Optimism, zkSync, Blast, BSC, Polygon. Sequencer downtime, different opcodes, gas pricing differences, precompile availability, block time assumptions | 29+ |
| 17 | evm-audit-flashloans | Flash loan attack patterns, oracle manipulation via flash loans, governance flash loan voting, flash mint issues, composability risks | 15+ |
| 18 | evm-audit-erc721 | NFT-specific issues: onERC721Received callbacks, enumeration DoS, royalty enforcement, metadata manipulation, batch mint edge cases | 20+ |
| 19 | evm-audit-dos | Denial of service patterns: unbounded loops, block gas limit, self-destruct force-send, storage deletion costs, griefing via revert, return data bombs | 18+ |
| 20 | evm-audit-access-control | Access control patterns: missing modifiers, 2-step ownership, role-based permissions, emergency pause, time delays, admin overpowers | 15+ |
Total: 500+ checklist items across 19 specialized skills + 1 master index
Routing Table — Which Skills To Load
| If the contract involves... | Load skill |
|---|---|
| Any EVM contract (always) | evm-audit-general |
| Any math/pricing/fees (always) | evm-audit-precision-math |
| Accepts ERC20 tokens (deposits, swaps, collateral) | evm-audit-erc20 |
| AMM, DEX, swap router, Uniswap V3/V4 hooks, liquidity pools, CLMs | evm-audit-defi-amm |
| Lending, borrowing, CDP, liquidation, AAVE/Compound fork | evm-audit-defi-lending |
| Staking, liquid staking (stETH/rETH/cbETH), restaking, EigenLayer | evm-audit-defi-staking |
| ERC4626 vaults, share/asset conversion, yield vaults | evm-audit-erc4626 |
| Account abstraction, smart wallets, paymasters, session keys | evm-audit-erc4337 |
| Cross-chain bridges, LayerZero, CCIP, Wormhole, Across | evm-audit-bridges |
| Upgradeable contracts, proxies (UUPS/Transparent/Beacon/Diamond) | evm-audit-proxies |
| Off-chain signatures, EIP-712, permits, meta-transactions | evm-audit-signatures |
| DAO governance, voting, timelocks, multi-sig, proposal execution | evm-audit-governance |
| Price oracles (Chainlink, TWAP, Pyth), VRF, external data | evm-audit-oracles |
| Inline assembly, Yul, CREATE2, low-level calls, precompiles | evm-audit-assembly |
| Non-mainnet (Arbitrum, OP, zkSync, Blast, BSC, Polygon) | evm-audit-chain-specific |
| Flash loans, composability attacks | evm-audit-flashloans |
| NFTs, ERC721, ERC1155, metadata, royalties | evm-audit-erc721 |
| DoS vectors, gas griefing, unbounded operations | evm-audit-dos |
| Access control, roles, ownership, emergency controls | evm-audit-access-control |
Audit Methodology
Phase 1: Reconnaissance
1. Fetch all contract files (raw GitHub URL or local path) 2. Identify all contract files, entry points, and external dependencies 3. Map inheritance hierarchy and proxy relationships 4. Identify all external calls and token interactions 5. Note the target deployment chain(s)
Phase 2: Skill Selection
Load evm-audit-general + evm-audit-precision-math (always), then add skills based on the routing table above. For a typical DeFi protocol, expect to load 6-8 skills.
Phase 3: Spawn Parallel Sub-Agents
Spawn one opus sub-agent per selected skill. Do not run skills sequentially in the main session — parallel agents produce dramatically better results by keeping each agent's context focused.
Each agent receives:
- The full contract source
- Their one checklist (read from
references/checklist.md) - The standard finding format (below)
- Output path:
audits/<repo>-<date>/findings-<skill>.md
Wait for all agents to complete, then proceed to Phase 4.
Phase 4: Synthesis
Read all findings-*.md files. Deduplicate findings that multiple agents flagged. Check for cross-cutting concerns:
- [ ] Interactions between finding categories (e.g., oracle manipulation + liquidation)
- [ ] State machine consistency across all state transitions
- [ ] Economic attack vectors combining multiple findings
Write final AUDIT-REPORT.md with all findings ranked by severity.
Phase 5: File Issues (if repo provided)
Run gh issue create --repo <owner/repo> for every finding Medium severity and above. Skip Info and Low unless explicitly asked. Each issue title should be prefixed: [Critical], [High], or [Medium].
---
Standard Finding Format
Every sub-agent and the synthesis step MUST use this exact format. No deviations.
~~~
[X-N] Title
Severity: Critical / High / Medium / Low / Info Category: [skill name that caught this] Location: functionName() or file:line Description: What the issue is and why it matters. Be specific — name the variable, line, or pattern. Proof of Concept: Exact steps to trigger or exploit. If not exploitable, explain the failure mode. Recommendation: Concrete fix with code snippet where possible. ~~~
Severity definitions (use these, not your own judgment):
- Critical: Direct loss of funds by a third party, no preconditions
- High: Loss of funds requiring specific conditions, or permanent DoS
- Medium: Degraded behavior, trust model violation, incorrect accounting, or owner-only fund loss
- Low: Best practice violation, latent bug, or confusing behavior without direct fund risk
- Info: Informational, no security impact
Source Attribution Key
[beirao]— beirao.xyz audit checklist[Dacian]— dacian.me security articles (8 deep-dive articles covering liquidation, CLM, slippage, precision, signatures, governance, assembly, lending)[Devdacian Primer]— devdacian/ai-auditor-primers GitHub (base.primer.md — comprehensive 33KB primer)[Decurity AMM/CDP/LSD]— Decurity protocol-specific checklists[weird-erc20]— d-xo/weird-erc20 repository[multichain-auditor]— 0xJuancito multichain auditor[SigmaPrime]— Sigma Prime security blog (governance, oracles, liquid restaking articles)[RareSkills]— RareSkills security articles (smart contract security, UUPS proxy)[Cyfrin]— Cyfrin/Dacian Chainlink oracle security article[ERC4626 checklist]— ERC4626 security checklist[ERC4626 primer]— ERC4626 vulnerability primer (85+ patterns)[ERC4337 checklist]— Account abstraction security checklist[Hacken UniV4]— Hacken Uniswap V4 hooks audit guide[LayerZeroV2 checklist]— LayerZero V2 security checklist[CCIP checklist]— Chainlink CCIP best practices[Wormhole checklist]— Wormhole integration security[Across checklist]— Across Protocol integration guide[Spearbit bridge]— Spearbit bridge security checklist[mixbytes CREATE2]— MixBytes CREATE2 security analysis[SWC-XXX]— Smart Contract Weakness Classification registry (superseded by EEA EthTrust)[Arbitrum docs]— Arbitrum official documentation[Blast docs]— Blast L2 documentation
EVM Audit Skill Suite — Source Tracking
Date fetched: 2026-02-27
Successfully Fetched Sources
Dacian Articles (via archive.org — all 8 articles)
| Source | URL | Status |
|---|---|---|
| DeFi Liquidation Vulnerabilities | https://dacian.me/defi-liquidation-vulnerabilities | ✅ via archive.org (50KB, truncated — very dense) |
| CLM Vulnerabilities | https://dacian.me/concentrated-liquidity-manager-vulnerabilities | ✅ via archive.org (20KB, complete) |
| DeFi Slippage Attacks | https://dacian.me/defi-slippage-attacks | ✅ via archive.org (27KB, complete) |
| Precision Loss Errors | https://dacian.me/precision-loss-errors | ✅ via archive.org (30KB, complete) |
| Signature Replay Attacks | https://dacian.me/signature-replay-attacks | ✅ via archive.org (15KB, complete) |
| DAO Governance DeFi Attacks | https://dacian.me/dao-governance-defi-attacks | ✅ via archive.org (50KB, truncated) |
| Inline Assembly Vulnerabilities | https://dacian.me/solidity-inline-assembly-vulnerabilities | ✅ via archive.org (35KB, complete) |
| Lending/Borrowing DeFi Attacks | https://dacian.me/lending-borrowing-defi-attacks | ✅ via archive.org (29KB, complete) |
Devdacian GitHub
| Source | URL | Status |
|---|---|---|
| AI Auditor Primers — base.primer.md | https://raw.githubusercontent.com/devdacian/ai-auditor-primers/main/primers/base.primer.md | ✅ (33KB) |
| AI Auditor Primers — amy.vault.erc4626.primer.md | https://raw.githubusercontent.com/devdacian/ai-auditor-primers/main/primers/amy.vault.erc4626.primer.md | ✅ listed (299KB — too large to process fully) |
| Primers repo tree | https://api.github.com/repos/devdacian/ai-auditor-primers/git/trees/main?recursive=1 | ✅ (2 primers found) |
RareSkills
| Source | URL | Status |
|---|---|---|
| Smart Contract Security | https://www.rareskills.io/post/smart-contract-security | ✅ via archive.org (50KB, truncated) |
| UUPS Proxy | https://www.rareskills.io/post/uups-proxy | ✅ via archive.org (21KB, complete) |
Sigma Prime
| Source | URL | Status |
|---|---|---|
| Governance & DAOs | https://blog.sigmaprime.io/governance-dao.html | ✅ direct (17KB) |
| Oracles & Pricing | https://blog.sigmaprime.io/oracles-and-pricing.html | ✅ direct (20KB) |
| Liquid Restaking | https://blog.sigmaprime.io/liquid-restaking.html | ✅ direct (26KB) |
Cyfrin / Dacian
| Source | URL | Status |
|---|---|---|
| Chainlink Oracle Security | https://medium.com/cyfrin/chainlink-oracle-defi-attacks-93b6cb6541bf | ✅ direct (22KB) |
SWC Registry
| Source | URL | Status |
|---|---|---|
| README | https://raw.githubusercontent.com/SmartContractSecurity/SWC-registry/master/README.md | ✅ (registry no longer maintained since 2020, superseded by EEA EthTrust Security Levels) |
Failed Sources
| Source | URL | Reason |
|---|---|---|
| Dacian direct (all URLs) | https://dacian.me/* | 429 — Vercel Security Checkpoint (bot protection). Resolved via archive.org. |
| ConsenSys Best Practices | https://consensys.github.io/smart-contract-best-practices/attacks/ | 404 — GitHub Pages site no longer at this path |
| MixBytes — Liquid Staking | https://mixbytes.io/blog/liquid | Fetch failed (connection error) |
| MixBytes — Account Abstraction | https://mixbytes.io/blog/account-abstraction | Not attempted (similar expected failure) |
| Solodit Checklist | https://solodit.cyfrin.io/checklist | JS-rendered, requires browser. Archive.org not attempted. |
| Blast Integration Bugs | https://nirlin-blast-bugs.notion.site/... | Notion pages require JS rendering |
| DeFi Llama Hacks | https://defillama.com/hacks | JS-rendered dashboard |
| Rekt News | https://rekt.news | Referenced in articles but not independently fetched |
| OpenZeppelin CHANGELOG | https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/CHANGELOG.md | Not fetched (very large, low signal-to-noise ratio) |
Notes
- SWC Registry has not been updated since 2020 and has been superseded by the EEA EthTrust Security Levels Specification. All SWC weaknesses were incorporated into that spec. Existing checklist items already cover the most critical SWC entries.
- Devdacian's base.primer.md (33KB) is an extremely high-quality comprehensive primer covering lending, liquidation, signatures, precision, slippage, oracle, CLM, staking, auction, and reentrancy vulnerability patterns with detailed invariants and checklists. Content from this primer has been cross-referenced and integrated.
- All Dacian articles were successfully fetched via Wayback Machine (archive.org) after direct access was blocked by Vercel bot protection.
- Total extracted content: ~450KB of high-quality audit security content processed into checklist items across 8+ skill files.
Related skills
FAQ
How do I start an EVM audit with this skill?
Always load evm-audit-master first, read the contracts under audit, then use the routing table to load the relevant specialized skills and walk each checklist.
How many audit skills does it index?
20 skills, from cross-cutting general issues to ERC20, DeFi AMM/lending/staking, ERC4626, proxies, oracles, signatures, bridges, and flash loans.