Skip to content

ccashwell/evm-cortex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EVM Cortex

EVM Cortex

Ethereum protocol engineering squad for AI coding assistants.

50 agents, 90 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

90 Skills

Category Skills
Solidity Dev (12) solidity-patterns 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:

License

MIT

About

Ethereum protocol engineering squad for AI coding assistants

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors