proxy-patterns

Compare Solidity upgradeable proxy patterns including UUPS, Transparent, Beacon, and Diamond.

2|1|Updated Nov 13, 2025
One-click install
npx skills add https://github.com/MolcajeteAI/plugin --skill proxy-patterns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proxy-patterns
Source: https://github.com/MolcajeteAI/plugin/tree/main/deprecated/tech-stacks/solidity/skills/proxy-patterns
Command: npx skills add https://github.com/MolcajeteAI/plugin --skill proxy-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides guidance and examples for implementing and understanding various proxy patterns in Solidity, crucial for creating upgradeable smart contracts.

Core Features & Use Cases

  • Pattern Comparison: Offers a clear overview of UUPS, Transparent, Beacon, and Diamond proxy patterns, detailing their best use cases, upgrade locations, and complexity.
  • Implementation Snippets: Includes basic Solidity code examples for UUPS and Transparent proxies.
  • Storage Rules: Emphasizes critical rules for safe state variable management during upgrades.
  • Use Case: When developing or auditing an upgradeable smart contract, use this Skill to quickly reference the pros and cons of different proxy strategies and ensure correct storage layout.

Quick Start

Use the proxy-patterns skill to understand the UUPS proxy pattern for upgradeable smart contracts.

Frequently Asked Questions about proxy-patterns

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

FAQPage Schema
What are the different upgradeable proxy patterns available for Solidity smart contracts?

Solidity upgradeable proxy patterns include UUPS, Transparent, Beacon, and Diamond. Each pattern varies in complexity, upgrade location, and best use cases for managing smart contract state and logic.

How do I choose between UUPS and Transparent proxies for my Ethereum smart contract?

UUPS places the upgrade logic in the implementation contract, reducing deployment costs, while Transparent proxies use a separate admin contract. Choose based on your desired gas efficiency and access control architecture.

How do I manage storage layout safely when upgrading Solidity smart contracts?

To manage storage layout safely during smart contract upgrades, you must follow critical rules that prevent state variable collisions. Never change the order or type of existing variables, only append new ones.

When should I use the Diamond proxy pattern for blockchain smart contracts?

Use the Diamond proxy pattern when your upgradeable smart contract exceeds the 24KB size limit. It allows multiple implementation contracts to route function calls through a single proxy address.