Agent skill

Minimal Proxy

by ccashwell in ccashwell/evm-cortex

A skill your agent uses when deploying many identical contracts cheaply with EIP-1167 minimal proxy (clones).

MITAuto-check passed

Install Minimal Proxy

skills CLI
$ npx skills add ccashwell/evm-cortex --skill minimal-proxy -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ccashwell/evm-cortex minimal-proxy --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ccashwell/evm-cortex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/minimal-proxy .claude/skills/minimal-proxy && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
minimal-proxy
GitHub stars
131
Token cost
~1.7k tokens
SKILL.md length
259 words
Files
1
Skills in repo
89
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when deploying many identical contracts cheaply with EIP-1167 minimal proxy (clones).

  • Deploying many identical contracts cheaply with EIP-1167 minimal proxy (clones)
  • SKILL.md covers Overview, Clone Bytecode, Factory Pattern with… and Implementation Contract (Clone…, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Minimal Proxy is an agent skill from ccashwell/evm-cortex. Use when deploying many identical contracts cheaply with EIP-1167 minimal proxy (clones). Covers Clones library, initialization patterns, gas efficiency, factory patterns, and limitations.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Ethereum protocol engineering squad for AI coding assistants. The licence is MIT.

When your agent uses it

  • Deploying many identical contracts cheaply with EIP-1167 minimal proxy (clones)

Example prompts

  • “/minimal-proxy”

What it can do on your machine

Read from SKILL.md and the folder at commit f8f3301. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are solidity).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Minimal Proxy loads about 1.7k tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 259 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ccashwell/evm-cortex at commit f8f3301, republished under its MIT licence (© ccashwell). 259 words, ~1,727 tokens.

Download SKILL.mdSave it as .claude/skills/minimal-proxy/SKILL.md (or your agent's skills folder).
name
minimal-proxy
description
Use when deploying many identical contracts cheaply with EIP-1167 minimal proxy (clones). Covers Clones library, initialization patterns, gas efficiency, factory patterns, and limitations.

EIP-1167 Minimal Proxy (Clones)

Overview

EIP-1167 defines a minimal bytecode proxy that delegates all calls to a known implementation. The clone is only 45 bytes of bytecode and costs ~36,000 gas to deploy (vs ~200,000+ for a full contract). Not upgradeable — the implementation address is baked into the bytecode.

Clone Bytecode

363d3d373d3d3d363d73<implementation>5af43d82803e903d91602b57fd5bf3

This is a pure delegatecall forwarder. All storage lives in the clone, logic executes from the implementation.

Factory Pattern with OpenZeppelin Clones

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import {Clones} from "@openzeppelin/contracts/proxy/Clones.sol";

contract VaultFactory {
    using Clones for address;

    address public immutable implementation;
    address[] public allVaults;

    event VaultCreated(address indexed vault, address indexed owner, uint256 index);

    constructor(address implementation_) {
        implementation = implementation_;
    }

    function createVault(
        address owner,
        address asset,
        string calldata name
    ) external returns (address vault) {
        vault = implementation.clone();
        IVault(vault).initialize(owner, asset, name);
        allVaults.push(vault);
        emit VaultCreated(vault, owner, allVaults.length - 1);
    }

    function createVaultDeterministic(
        address owner,
        address asset,
        string calldata name,
        bytes32 salt
    ) external returns (address vault) {
        vault = implementation.cloneDeterministic(salt);
        IVault(vault).initialize(owner, asset, name);
        allVaults.push(vault);
        emit VaultCreated(vault, owner, allVaults.length - 1);
    }

    function predictAddress(bytes32 salt) external view returns (address) {
        return implementation.predictDeterministicAddress(salt, address(this));
    }

    function vaultCount() external view returns (uint256) {
        return allVaults.length;
    }
}

Implementation Contract (Clone Target)

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import {Initializable} from "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";

interface IVault {
    function initialize(address owner, address asset, string calldata name) external;
}

contract Vault is Initializable, IVault {
    using SafeERC20 for IERC20;

    address public owner;
    IERC20 public asset;
    string public name;

    modifier onlyOwner() {
        require(msg.sender == owner, "Not owner");
        _;
    }

    /// @custom:oz-upgrades-unsafe-allow constructor
    constructor() { _disableInitializers(); }

    function initialize(address owner_, address asset_, string calldata name_)
        external override initializer
    {
        owner = owner_;
        asset = IERC20(asset_);
        name = name_;
    }

    function deposit(uint256 amount) external {
        asset.safeTransferFrom(msg.sender, address(this), amount);
    }

    function withdraw(uint256 amount) external onlyOwner {
        asset.safeTransfer(owner, amount);
    }
}

Gas Comparison

OperationFull DeployClone DeploySavings
Deploy cost~500,000 gas~46,000 gas~91%
Runtime overhead0~700 gas/callNegligible
Bytecode sizeFull contract45 bytes~99%

For protocols deploying many instances (vaults, escrows, pools), clones can save millions of gas.

Deterministic Clones (CREATE2)

Predict clone addresses before deployment:

solidity
bytes32 salt = keccak256(abi.encode(msg.sender, tokenAddress, block.timestamp));
address predicted = Clones.predictDeterministicAddress(implementation, salt, address(factory));

// Deploy later:
address deployed = Clones.cloneDeterministic(implementation, salt);
assert(deployed == predicted);

Clones with Immutable Args (CWIA)

For clones that need constructor-like args baked into bytecode (not storage), use the CWIA pattern. Args are appended to the clone bytecode and read via calldataload:

solidity
import {ClonesWithImmutableArgs} from "clones-with-immutable-args/ClonesWithImmutableArgs.sol";

contract Factory {
    using ClonesWithImmutableArgs for address;

    function createClone(address impl, address owner, uint256 threshold)
        external returns (address)
    {
        bytes memory data = abi.encodePacked(owner, threshold);
        return impl.clone(data);
    }
}

contract CloneImpl {
    function _getArgAddress(uint256 argOffset) internal pure returns (address) {
        return address(uint160(_getArgUint256(argOffset)));
    }

    function owner() public pure returns (address) {
        return _getArgAddress(0);
    }

    function threshold() public pure returns (uint256) {
        return _getArgUint256(20);
    }
}

Limitations

  • Not upgradeable: Implementation address is hardcoded in bytecode
  • Same bytecode: All clones share the same logic, differ only in storage
  • No constructor: Must use initialize pattern
  • Double-init risk: Always use Initializable to prevent re-initialization
  • address(this) in implementation: Returns the clone's address (correct behavior)
  • Cannot receive ETH without receive(): Implementation must have receive() if clones need to accept ETH

Testing

solidity
function test_cloneFactory() public {
    Vault impl = new Vault();
    VaultFactory factory = new VaultFactory(address(impl));

    address vault1 = factory.createVault(alice, address(usdc), "Vault 1");
    address vault2 = factory.createVault(bob, address(weth), "Vault 2");

    // Different addresses, same logic
    assertTrue(vault1 != vault2);
    assertEq(Vault(vault1).owner(), alice);
    assertEq(Vault(vault2).owner(), bob);

    // Cannot re-initialize
    vm.expectRevert();
    Vault(vault1).initialize(bob, address(weth), "Hijack");
}

function test_deterministicClone() public {
    bytes32 salt = keccak256("test");
    address predicted = factory.predictAddress(salt);
    address deployed = factory.createVaultDeterministic(alice, address(usdc), "V1", salt);
    assertEq(predicted, deployed);
}

When to Use Clones

  • Use when: Deploying many instances of the same contract (pools, vaults, escrows, accounts)
  • Don't use when: Contracts need upgradeability, or each instance has different logic
  • Consider CWIA when: Clones need immutable configuration that doesn't change after deploy

© ccashwell, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/minimal-proxy of ccashwell/evm-cortex.

Open the folder on GitHubat commit f8f3301

Compare with similar skills

Minimal Proxy next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Minimal Proxy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Minimal Proxy this skillccashwell/evm-cortex131—~1.7kAutomated safety check: PassMIT
Configuring Identity Aware Proxy With Google Iapmukul975/Anthropic-Cybersecurity-Skills34k—~3.7kAutomated safety check: PassApache-2.0
Deploy Setupgarrytan/gstack136k—~11kAutomated safety check: NotesMIT
Deployment Patternsaffaan-m/ECC274k1 repos~2.9kAutomated safety check: PassMIT
Vercel Deploybytedance/deer-flow83k10 repos~797Automated safety check: PassMIT
Land and Deploygarrytan/gstack136k—~18kAutomated safety check: NotesMIT

Similar skills

  • Configuring Identity Aware Proxy With Google Iap

    mukul975/Anthropic-Cybersecurity-Skills

    Configures Google Cloud Identity-Aware Proxy (IAP) via gcloud to enforce per-request identity verification on Compute Engine, App Engine, Cloud Run, and GKE, including IAM bindings, Access Context…

    34k GitHub stars~3.7k tokensUpdated 1 mo ago
    SecurityAuto-check passed
  • Deploy Setup

    garrytan/gstack

    Detects where an app deploys, its production URL and health checks, then saves the deploy configuration in CLAUDE.md for /land-and-deploy.

    136k GitHub stars~11k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Deployment iş akışları, CI/CD pipeline kalıpları, Docker konteynerizasyonu, sağlık kontrolleri, rollback stratejileri ve web uygulamaları için üretim hazırlığı kontrol listeleri.

    274k GitHub starsUsed in 1 repo~2.9k tokens
    DevOps & CloudAuto-check passed
  • Vercel Deploy

    bytedance/deer-flow

    Deploys a project to Vercel with one script and no login, then returns a live preview URL and a claim link for moving the deployment into your own Vercel account.

    83k GitHub starsUsed in 10 repos~797 tokens
    DevOps & CloudAuto-check passed
  • Land and Deploy

    garrytan/gstack

    Merges a pull request, waits for CI and the deploy, then verifies production health with canary checks, picking up where /ship leaves off.

    136k GitHub stars~18k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Covers rolling, blue-green and canary deployments, multi-stage Dockerfiles, a GitHub Actions pipeline, health checks and production readiness for web apps.

    274k GitHub starsUsed in 6 repos~2.8k tokens
    DevOps & CloudAuto-check passed

More from ccashwell/evm-cortex

All 89 skills in this repo
  • Xray Pre Audit

    ccashwell/evm-cortex

    A skill your agent uses when preparing for a security audit, performing reconnaissance on a new codebase, or creating a protocol overview.

    131 GitHub stars~25k tokensUpdated 8 days ago
    Auto-check passed
  • Aave Integration

    ccashwell/evm-cortex

    A skill your agent uses when integrating with Aave V3 for lending, borrowing, flash loans, or building on top of Aave markets.

    131 GitHub stars~1.3k tokensUpdated 8 days ago
    Auto-check passed
  • Access Control Patterns

    ccashwell/evm-cortex

    Access control design patterns for Solidity protocols. An agent skill from ccashwell/evm-cortex.

    131 GitHub stars~1.8k tokensUpdated 8 days ago
    Auto-check passed
  • Anvil Patterns

    ccashwell/evm-cortex

    A skill your agent uses when running a local Ethereum node with Anvil.

    131 GitHub stars~1.3k tokensUpdated 8 days ago
    Auto-check passed
  • Audit Breadth Scan

    ccashwell/evm-cortex

    A skill your agent uses when performing systematic breadth-first review of all contracts during a security audit.

    131 GitHub stars~1.4k tokensUpdated 8 days ago
    Auto-check passed
  • Audit Depth Analysis

    ccashwell/evm-cortex

    A skill your agent uses when performing deep analysis of specific findings or high-risk areas during a security audit.

    131 GitHub stars~1.6k tokensUpdated 8 days ago
    Auto-check passed

Questions about Minimal Proxy

What does Minimal Proxy do?

A skill your agent uses when deploying many identical contracts cheaply with EIP-1167 minimal proxy (clones). Minimal Proxy is an agent skill from ccashwell/evm-cortex. Use when deploying many identical contracts cheaply with EIP-1167 minimal proxy (clones).

When should I use Minimal Proxy?

Minimal Proxy fits situations like: deploying many identical contracts cheaply with EIP-1167 minimal proxy (clones).

How do I install Minimal Proxy in Claude Code?

Run `npx skills add ccashwell/evm-cortex --skill minimal-proxy -a claude-code`. Or copy the skill folder (skills/minimal-proxy in ccashwell/evm-cortex) into .claude/skills/minimal-proxy in your project. Claude Code loads it when a task matches its description.

How do I install Minimal Proxy in Codex?

Run `npx skills add ccashwell/evm-cortex --skill minimal-proxy -a codex`. Or copy the skill folder (skills/minimal-proxy in ccashwell/evm-cortex) into .agents/skills/minimal-proxy in your project. Codex loads it when a task matches its description.

Can I use Minimal Proxy in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ccashwell/evm-cortex --skill minimal-proxy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/minimal-proxy, .gemini/skills/minimal-proxy, .github/skills/minimal-proxy and .opencode/skills/minimal-proxy in your project.

What does Minimal Proxy need to run?

SKILL.md names no scripts, command-line tools or credentials: Minimal Proxy is instructions for the agent only.

Does Minimal Proxy access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Minimal Proxy safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Minimal Proxy use?

Minimal Proxy is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Minimal Proxy use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Minimal Proxy?

Skills that share tags, products or a category with Minimal Proxy: Configuring Identity Aware Proxy With Google Iap (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), Deploy Setup (garrytan/gstack, 136k stars), Deployment Patterns (affaan-m/ECC, 274k stars) and Vercel Deploy (bytedance/deer-flow, 83k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Minimal Proxy?

ccashwell (a GitHub user) maintains it in ccashwell/evm-cortex, which has 131 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on September 30, 2026.

Source: ccashwell/evm-cortex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.