Setup Solidity Contracts

Handles the boilerplate of getting a Solidity project off the ground with OpenZeppelin contracts, whether you're using Hardhat or Foundry. It'll detect your framework if you've already started, or walk you through initialization if you haven't. The remappings guidance for Foundry is genuinely helpful since that's where most people mess up, especially the note about how upgradeable contract remappings need to point everything through the upgradeable submodule for Etherscan verification to work. Solid time saver if you're spinning up smart contract projects regularly and tired of looking up the same forge install commands and import paths every time.

skills.sh installs: 600
GitHub stars: 222
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add openzeppelin/openzeppelin-skills --skill setup-solidity-contracts --agent claude-code

Installs into .claude/skills of the current project.

Files

Solidity Setup

For existing projects, detect the framework by looking for hardhat.config.* (Hardhat) or foundry.toml (Foundry). For new projects, ask the user which framework they prefer.

Hardhat Setup

Initialize project (only if starting a new project)

npx hardhat init        # Hardhat v2
npx hardhat --init      # Hardhat v3

Install OpenZeppelin Contracts:

npm install @openzeppelin/contracts

If using upgradeable contracts, also install the upgradeable variant:

npm install @openzeppelin/contracts-upgradeable

Foundry Setup

Install Foundry

curl -L https://foundry.paradigm.xyz | bash
foundryup

Initialize project (only if starting a new project)

forge init my-project
cd my-project

Add OpenZeppelin Contracts:

forge install OpenZeppelin/openzeppelin-contracts@v<VERSION>

If using upgradeable contracts, also add the upgradeable variant:

forge install OpenZeppelin/openzeppelin-contracts-upgradeable@v<VERSION>

SKILL.md on GitHub

Details

Repository: github.com/openzeppelin/openzeppelin-skills
Category: Web3 & Blockchain
First seen: Jun 3, 2026

More from openzeppelin/openzeppelin-skills

All 5