proxy-patterns

Selects upgradeable proxy patterns for smart contracts based on specified requirements.

120|12|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ccashwell/evm-cortex --skill proxy-patterns-ccashwell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proxy-patterns
Source: https://github.com/ccashwell/evm-cortex/tree/main/skills/proxy-patterns
Command: npx skills add https://github.com/ccashwell/evm-cortex --skill proxy-patterns-ccashwell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Selecting the right upgradeable proxy pattern can be complex due to multiple approaches (UUPS, Transparent, Beacon, Minimal, Diamond). This Skill guides engineers to evaluate upgradeability tradeoffs, gas costs, and security considerations to make a confident choice.

Core Features & Use Cases

  • Pattern comparison across UUPS, Transparent Upgradeable Proxy, Beacon, Minimal, and Diamond architectures.
  • Decision guidance for upgrade strategies based on contract size, governance needs, and deployment environment.
  • Use Case: When building an upgradable protocol, choose a pattern that balances upgrade flexibility with gas efficiency and security.

Quick Start

Analyze your upgrade requirements and ask for a recommended proxy pattern based on your contract goals.

Frequently Asked Questions about proxy-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose the best upgradeable proxy pattern for my Solidity smart contracts?

To choose the best upgradeable proxy pattern, evaluate your contract's upgradeability, gas costs, and security requirements. Compare UUPS, Transparent, Beacon, Minimal, and Diamond architectures to balance upgrade flexibility with gas efficiency for your deployment scale.

What is the difference between UUPS, Beacon, and Diamond proxy architectures?

UUPS places upgrade logic in the implementation for lower gas, Beacon proxies route multiple contracts to one implementation, and Diamond architectures enable modular contract upgrades. The right proxy pattern depends on your governance needs and contract size.

When do I need a minimal proxy instead of a standard upgradeable proxy?

You need a minimal proxy, following EIP-1167, when deploying many identical contracts and prioritizing low gas costs over complex upgradeability. Minimal proxies delegate calls to a single implementation, drastically reducing deployment gas costs.

How do gas costs and security checks influence proxy pattern selection?

Gas costs and security checks heavily influence proxy pattern selection by dictating deployment and execution overhead. Evaluating these factors ensures the chosen proxy architecture, like UUPS or Transparent, meets secure upgrade requirements without excessive gas.

Can I use proxy patterns for a protocol with complex governance needs?

You can use proxy patterns for protocols with complex governance needs by selecting architectures like Transparent or Diamond proxies. These patterns support advanced upgrade strategies that securely manage contract logic changes based on governance decisions.