Claude-Solidity-Skills

Claude Solidity Skills Plugin

A Claude Code plugin providing production-grade skills for Solidity development. Each skill encodes battle-tested methodology from the best public resources in the ecosystem.

Installation

One-Click Plugin Install (Recommended)

# Add marketplace
/plugin marketplace add max-taylor/Claude-Solidity-Skills

# Install plugin
/plugin install solidity-skills@Claude-Solidity-Skills

Or via CLI:

claude plugin marketplace add max-taylor/Claude-Solidity-Skills
claude plugin install solidity-skills@Claude-Solidity-Skills

Local (for development)

claude --plugin-dir ./solidity-skills

Skills

/solidity-skills:test-hardhat — Hardhat Test Generation

Generates comprehensive Hardhat v3 test suites with structured coverage across unit, integration, and end-to-end testing layers.

What it does:

• Reads and analyzes the target contract's full interface (functions, modifiers, events, errors, state)
• Produces a test plan covering deployment, per-function happy/sad paths, access control, boundary cases, and multi-step integration flows
• Writes TypeScript tests using loadFixture, Chai matchers, and hardhat-network-helpers
• Outputs a coverage summary mapping tests to every require, event, and modifier

Invoke:

/solidity-skills:test-hardhat MyContract.sol

Resources used to build this skill:

• Hardhat v3 Testing Guide — Hardhat's official dual Solidity/TypeScript testing approach, fixtures, and network helpers
• Moloch DAO Test README — Verification helper pattern, DRY test philosophy, per-require coverage discipline, and state machine testing methodology
• Smart Contract Security Field Guide — Testing — Test planning hierarchy (unit → integration → e2e → fuzz), TDD workflow, invariant testing philosophy
• Ethereum.org — Smart Contract Testing — Canonical testing taxonomy (unit, integration, property-based, static/dynamic analysis), tool landscape overview

---

/solidity-skills:test-foundry — Foundry/Forge Test Generation

Generates comprehensive Forge test suites with first-class support for fuzz testing, invariant testing, and fork testing.

What it does:

• Reads and analyzes the target contract's full interface
• Produces a test plan covering unit tests, fuzz tests, invariant tests with handler contracts, and fork tests
• Writes Solidity tests using forge-std's Test base, cheatcodes (vm.prank, vm.expectRevert, vm.expectEmit, vm.warp, deal, etc.), and bound() for input constraining
• Generates handler contracts for invariant testing with ghost variables and multi-actor simulation
• Outputs a coverage summary including fuzz and invariant coverage

Invoke:

/solidity-skills:test-foundry MyContract.sol

Resources used to build this skill:

• Foundry Book — Writing Tests — Test structure, setUp(), naming conventions (test_, testFuzz_, invariant_), assertion library, verbosity flags
• Foundry Book — Cheatcodes Overview — Full vm.* cheatcode reference (prank, expectRevert, expectEmit, warp, roll, deal, store, mockCall, etc.)
• Foundry Book — Invariant Testing Guide — Handler pattern, ghost variables, targetContract, targetSelector, bound() vs vm.assume(), multi-actor simulation, configuration
• Foundry Book — Fork Testing Guide — vm.createFork, vm.selectFork, block pinning, deal() for ERC20s, RPC caching
• Moloch DAO Test README — Verification helper pattern, per-require coverage discipline, state machine testing
• Smart Contract Security Field Guide — Testing — Test planning hierarchy, fuzz testing philosophy, invariant property identification
• Ethereum.org — Smart Contract Testing — Testing taxonomy and property-based testing methodology

---

/solidity-skills:gas-optimize — Gas Optimization Analysis

Analyzes a Solidity contract for gas optimization opportunities, ranked by impact with before/after code and estimated gas savings.

What it does:

• Analyzes storage layout, access patterns, and function hot paths
• Identifies savings across 7 categories: storage layout, data structures, function-level, arithmetic, assembly, compiler settings, and L2-specific considerations
• Provides before/after code with specific gas numbers for every recommendation
• Outputs a prioritized report (high/medium/low impact)

Invoke: