decipher-gas-optimizoor
Dedicated Solidity Smart Contract Gas optimizoor for your Solidity projects.
- 11 domain-specific EVM gas-optimization skills,
- 5 slash commands,
- 1 agent
- and a per-save regression guard
All you need to optimize your smart contracts.
Installation
Inside Claude Code, run:
Step 1: Add the marketplace
/plugin marketplace add zaryab2000/decipher-gas-optimizoor
Step 2: Install the marketplace
/plugin install decipher-gas-optimizoor@decipher-gas-optimizoor-marketplace
Quickstart
Prerequisites: Foundry installed · Claude Code installed · a Solidity project with foundry.toml and at least one test
Step 1 — Create a gas baseline
The regression guard compares every future save against this snapshot. Run once, then commit it.
/decipher-gas-optimizoor:baseline --update
git add .gas-snapshot && git commit -m "chore: gas baseline"
Do not add .gas-snapshot to .gitignore — it must be committed for the regression guard to work.
Step 2 — Run your first analysis
/decipher-gas-optimizoor:analyze src/
You'll get a prioritized findings report: severity, file + line, estimated gas saving, before/after code, and a top-3 action list.
Step 3 — Enable real-time annotations while editing
/decipher-gas-optimizoor:watch
After activation, every Solidity edit Claude makes gets a gas impact note appended to the response. Turn it off with /decipher-gas-optimizoor:watch --off.
Commands
| Command | What it does | Forge |
|---|
/decipher-gas-optimizoor:analyze [path] [--threshold N] | Full gas analysis of a contract or directory. Reports all findings sorted by estimated gas saving. | ✅ |
/decipher-gas-optimizoor:compare [ref1] [ref2] | Compares gas snapshots between two git refs (default: HEAD~1 vs HEAD). Shows per-function delta split into regressions and improvements. | ✅ |
/decipher-gas-optimizoor:baseline [--update|--show X] | Manages the .gas-snapshot baseline. --update regenerates it; --show X filters to matching functions; no args prints the full summary. | --update only |
/decipher-gas-optimizoor:explain <pattern> | EVM mechanic, exact gas numbers, before/after code, and when NOT to apply — for any listed pattern. | ❌ |
/decipher-gas-optimizoor:watch [--off] | Toggles per-edit gas annotation mode. Session-scoped. | ❌ |
--threshold — suppress findings below a minimum gas saving. Default is 100:
/decipher-gas-optimizoor:analyze src/ --threshold 500
Patterns for :explain — cold-sload · slot-packing · unchecked · custom-errors · calldata · external-vs-public · immutable · loop-caching · unbounded-loop
Skills — Auto-Applied
Skills fire automatically as you write Solidity. You never invoke them directly.
zaryab2000