Skip to main content
subagent CX Codex

smart-contract-specialist — Claude Code subagent for contract architecture

The smart-contract-specialist subagent for Claude Code advises on proxy patterns, upgradeable storage, and module boundaries; implementation goes to blockchain-developer, audits to smart-contract-auditor.

no license 708 installs updated 2026-10-24

Install into Claude Code · claude-code-templates All methods and platforms ↓
npx claude-code-templates@latest --agent blockchain-web3/smart-contract-specialist
Open on GitHub

What smart-contract-specialist does

The subagent handles smart contract architecture decisions: which proxy pattern to use (UUPS, Transparent, Beacon, or Diamond — the latter carries higher audit cost and complexity due to shared storage across facets; reserve it for cases that need independent module upgrades or hit contract size limits), how to lay out storage slots under EIP-7201 to avoid collisions on upgrades, where to draw module boundaries, and which token standard fits the use case (ERC-20, ERC-721, ERC-4626, ERC-7579 for modular smart accounts). It accounts for EIP-1153 (transient keyword for reentrancy guards without SSTORE cost), EIP-7702 (EOA delegation — an address can become a contract in the next block, so EXTCODESIZE checks no longer reliably distinguish EOAs), and the via_ir compiler flag for contracts hitting stack or gas limits.

It uses Read, Grep, Glob, WebSearch, and WebFetch to analyze code and find compatible OpenZeppelin references. Before recommending a proxy, it asks whether the contract will be upgraded and which network it targets. For any upgradeable contract, it requires EIP-7201 (the erc7201 builtin since Solidity 0.8.35) so re-delegation under EIP-7702 does not corrupt storage slots.

It supports Solidity up to 0.8.37; the experimental EOF backend was removed in 0.8.36, so EOF is off the table. It factors static analysis tools like Slither and Aderyn into the design upfront so downstream verification runs without rework.

What it helps with

  • choose a proxy pattern and lay out storage for an upgradeable contract
  • separate logic into modules without slot collisions
  • select a token standard that fits the protocol
  • account for EIP-7702 and transient in DeFi protocol architecture

Example prompts for the agent

  • I need a lending protocol with upgradeable contracts — which proxy pattern should I use and how do I lay out storage?
  • Which token standard should I pick for a modular smart account with validators and hooks?

How to install smart-contract-specialist

1claude-code-templates

npx claude-code-templates@latest --agent blockchain-web3/smart-contract-specialist

2Manually: put the files in place

.claude/agents/smart-contract-specialist.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about smart-contract-specialist

How to install smart-contract-specialist in Claude Code?

Run npx claude-code-templates@latest --agent blockchain-web3/smart-contract-specialist and the subagent will appear in .claude/agents/smart-contract-specialist.md.

What does smart-contract-specialist do?

It advises on smart contract architecture: proxy pattern selection, EIP-7201 storage layout design, module boundaries, and token standard selection. It hands off implementation and audits to other subagents.

When should I use Diamond instead of UUPS or Transparent?

When you need independently upgradeable modules or hit contract size limits. Diamond is more complex and costs more to audit because facets share storage.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →
solidity-security Seth Hobson The solidity-security skill helps write and audit Solidity contracts against common vulnerabilities. Use it for DeFi work, security checks, and audit preparation. CX Codex +1 15,382installs blockchain-developer Seth Hobson blockchain-developer is a Claude Code subagent for building smart contracts and Web3 applications. It activates for DeFi, NFT, and blockchain infrastructure work. CX Codex 375installs smart-contract-vulnerabilities yaklang smart-contract-vulnerabilities is a Claude Code skill that helps audit Solidity/EVM contracts for vulnerabilities. It covers common smart contract attack patterns. CX Codex +1 3,900installs Solidity Smart Contract taste f The Solidity Smart Contract taste prompt for ChatGPT, Claude.ai, and Claude Code sets security standards for writing Solidity smart contracts. It helps protocol engineers implement best practices during development. GP ChatGPT ★ 178,201repo stars analyzing-ethereum-smart-contract-vulnerabilities mahipal analyzing-ethereum-smart-contract-vulnerabilities runs static and symbolic analysis on Solidity smart contracts using Slither and Mythril. Catches reentrancy, integer overflows, and access flaws before deployment. CX Codex +1 398installs use-smart-contract-platform circlefin The use-smart-contract-platform Claude Code skill connects smart-contract tasks to Circle Smart Contract Platform APIs. Deploy contracts, call ABI functions, and watch contract events through webhooks. CX Codex +1 1,000installs

From the same set745

The whole set →
ai-ethics-advisor The ai-ethics-advisor subagent reviews AI systems for bias, fairness problems, and regulatory gaps. Use it for ethics audits and responsible-AI documentation. CX Codex 723installs bright-data-mcp This skill routes every web data task in Claude through the Bright Data MCP server instead of the built-in WebFetch and WebSearch. Useful when pages block bots or you want clean JSON. CX Codex +1 722installs planning planning keeps markdown files for goals, findings and session progress so an agent doesn't drift off the task mid-run. CX Codex +1 712installs context7-auto-research The context7-auto-research skill retrieves current library and framework references through the Context7 API. Use it when a Claude Code answer needs documentation for React, Next.js, Prisma, or another library. CX Codex +1 709installs smart-contract-auditor smart-contract-auditor audits EVM and Solidity smart contracts for exploits, logic flaws, and economic attack vectors. Useful for pre-deployment reviews and vulnerability reports. CX Codex 701installs nextjs-performance-audit nextjs-performance-audit — a Claude Code command that audits Next.js apps across three modes: Lighthouse scoring, bundle analysis, and runtime Core Web Vitals. Pass --lighthouse, --bundle, --runtime, or --all to target what you need. CX Codex +1 694installs agent-management The agent-management skill controls AI agents through the AI Maestro CLI, from creation and status checks to hibernation and plugin changes. Use it when several agents need lifecycle commands. CX Codex +1 690installs security-audit security-audit — a workflow skill that walks a web app or API through recon, vulnerability scanning, pentesting, hardening and reporting. CX Codex +1 673installs

Project sponsors

Companies that keep this analytics open