evm-cortex

EVM Cortex

Ethereum protocol engineering squad for AI coding assistants.

50 agents, 91 skills, 19 hooks, and 15 rules covering Solidity development, security auditing, DeFi integration, smart contract testing, and deployment — everything needed to build, audit, and ship smart contracts.

Install

Claude Code

git clone https://github.com/ccashwell/evm-cortex.git
cd evm-cortex
./install.sh

Codex CLI

git clone https://github.com/ccashwell/evm-cortex.git
cd evm-cortex
./install-codex.sh

Cursor

git clone https://github.com/ccashwell/evm-cortex.git
cd evm-cortex
./install-cursor.sh

OpenClaw

git clone https://github.com/ccashwell/evm-cortex.git
cd evm-cortex
./install-openclaw.sh

Or zero-copy (add to ~/.openclaw/openclaw.json):

{ "skills": { "load": { "extraDirs": ["/path/to/evm-cortex/skills"] } } }

Prerequisites

Tool	Install	Required
Foundry	curl -L https://foundry.paradigm.xyz | bash && foundryup	Yes
Slither	pip install slither-analyzer	Recommended
Aderyn	cargo install aderyn	Optional
Node.js 18+	nodejs.org	For hooks

What's Inside

50 Agents

Squad	Agents
Core Protocol (6)	solidity-architect solidity-engineer gas-optimizer contract-deployer storage-layout-analyst protocol-designer
Security (10)	audit-orchestrator access-control-reviewer depth-state-trace depth-token-flow depth-edge-case depth-external mev-analyst poc-writer security-verifier sleuth
Testing (5)	foundry-tester invariant-analyst invariant-tester formal-verifier fuzzer
DeFi (8)	amm-expert lending-expert oracle-analyst oracle-expert bridge-expert tokenomics-analyst yield-strategist defi-architect
Uniswap (5)	uniswap-v3-expert uniswap-v4-expert uniswap-math-expert lp-analyst pool-finder
Tooling (6)	foundry-expert openzeppelin-expert slither-analyst subgraph-builder dapp-frontend devops-chain
Standards (5)	eip-expert erc-implementer upgrade-planner governance-designer l2-specialist
Cross-Cutting (5)	planner code-reviewer scout scribe verifier

91 Skills

Category	Skills
Solidity Dev (13)	solidity-patterns type-driven-design gas-optimization storage-layout assembly-patterns error-handling event-design interface-design natspec-standards library-patterns immutable-constants constructor-patterns solidity-security
Security (15)	reentrancy-patterns flash-loan-attacks oracle-manipulation access-control-patterns signature-vulnerabilities front-running-patterns integer-overflow delegate-call-risks denial-of-service cross-chain-security upgrade-safety token-integration-safety economic-attack-vectors governance-attacks time-manipulation
DeFi (12)	uniswap-v4-hooks aave-integration compound-patterns curve-integration chainlink-oracles flash-loan-usage yield-vault-patterns staking-reward-patterns governance-patterns liquidity-mining token-bonding-curves dutch-auction-patterns
Uniswap (6)	uniswap-v4-testing uniswap-v4-expert uniswap-v3-expert uniswap-math lp-analyst pool-finder
Testing (8)	foundry-testing invariant-testing formal-verification fork-testing gas-snapshot-testing coverage-analysis fuzzing-patterns test-fixtures
Audit (8)	audit-prep audit-recon audit-breadth-scan audit-depth-analysis audit-verification audit-report-generation pashov-audit-pipeline xray-pre-audit
Standards (12)	erc20-patterns erc721-patterns erc1155-patterns erc4626-patterns erc7702-patterns erc8004-patterns eip712-signing create2-patterns proxy-patterns minimal-proxy diamond-pattern beacon-proxy
Stablecoins (2)	usdc-integration cctp-bridging
Tooling (8)	foundry-setup slither-analysis aderyn-analysis cast-commands anvil-patterns forge-scripting contract-verification blockscout-mcp
Infrastructure (7)	subgraph-patterns dapp-frontend-patterns wallet-integration l2-deployment multichain-deployment ipfs-deployment scaffold-eth-patterns

19 Hooks

Hook	Trigger
agent-memory-loader	Session start
agent-memory-saver	Session end
bash-audit-log	Shell command
credential-deny	Shell command
forge-compile-check	File save
gas-snapshot-diff	File save
memory-awareness	Session start
natspec-enforcer	File save
passive-learner	Session end
pre-compact-continuity	Context compact
sast-on-edit	File save
session-analytics	Session end
session-end-cleanup	Session end
session-outcome	Session end
session-register	Session start
session-start-continuity	Session start
slither-on-save	File save
storage-layout-check	File save
transcript-parser	Session end

15 Rules

solidity-style-guide security-first foundry-workflow gas-consciousness audit-mindset severity-matrix finding-output-format decimal-awareness evm-current-state onchain-conventions contract-addresses upgrade-safety-rules test-before-deploy report-template poc-execution

Recommended MCP Servers

Server	Purpose
OpenZeppelin MCP	Contract generation
Blockscout MCP	Onchain data queries
Slither MCP	Static analysis

Key Principles

Security first. Checks-effects-interactions. ReentrancyGuard. SafeERC20. Never trust external calls.

Foundry workflow. TDD with forge test. Gas snapshots for regression. Slither before merge.

Audit mindset. Write code as if it will be audited tomorrow. Document invariants. Test edge cases.

Current knowledge. Gas is under 1 gwei (2026). Foundry is the default toolchain. EIP-7702 is live. Say "onchain" not "on-chain".

Acknowledgments

Built on knowledge from:

• ethskills.com — Ethereum knowledge corrections for AI agents
• Plamen — Autonomous audit pipeline architecture
• OpenZeppelin Skills — Secure contract development
• evmresearch.io — EVM security research
• Circle Skills — USDC and CCTP integration patterns
• Pashov Skills — Security audit methodology

License

MIT