# token-minter

token-minter generates OpenZeppelin ERC20 smart contracts, compiles them with Foundry, and deploys to EVM networks like Sepolia. Useful when launching a token via an AI agent.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 158 installs · ★ 39 repo stars
- Author: kukapay
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/kukapay/crypto-skills/tree/HEAD/skills/token-minter/SKILL.md
- Updated: 2026-05-04
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/token-minter

## What it does

The skill gathers token details from the user: name, symbol, decimals (default: 18), and initial supply (default: 1000000). It then triggers `scripts/generate_contract.py` to write an OpenZeppelin-compatible ERC20 Solidity file.

Next, it initializes a temporary Foundry workspace under `./tmp/`, adds `OpenZeppelin/openzeppelin-contracts`, and compiles the contract with `forge build`. Deployment runs via `forge create` against an EVM RPC URL, such as `https://ethereum-sepolia.publicnode.com`.

Without Foundry installed and an account created via `cast wallet new` holding gas funds, the process will fail at the broadcast step.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add kukapay/crypto-skills --skill token-minter -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/token-minter/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/token-minter/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add kukapay/crypto-skills --skill token-minter -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/token-minter/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add kukapay/crypto-skills --skill token-minter -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/token-minter/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install kukapay/crypto-skills skills/token-minter
```

2. **Manually: put the files in place**
- File: `.github/skills/token-minter/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add kukapay/crypto-skills --skill token-minter -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/kukapay/crypto-skills --path skills/token-minter
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/token-minter/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add kukapay/crypto-skills --skill token-minter -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/kukapay/crypto-skills/tree/HEAD/skills/token-minter/SKILL.md

## When to use it
- generate standard ERC20 contract code with custom token parameters
- deploy an ERC20 token to the Sepolia testnet using Foundry
- compile OpenZeppelin contracts inside a temporary build directory

## Example prompts
- Create and deploy an ERC20 token named MyToken with symbol MTK on Sepolia.
- Generate an ERC20 smart contract with 6 decimals and prepare the Foundry build.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d1c29a01497fe20b.

BEGIN THIRD-PARTY FILE d1c29a01497fe20b
```text
---
name: token-minter
description: Generate, build, and deploy custom ERC20 tokens on EVM networks. Use when users want to create and deploy their own ERC20 tokens with custom parameters like name, symbol, decimals, and initial supply. Supports deployment to various networks including Sepolia testnet and requires Foundry (forge/cast) for blockchain interactions.
---

# Token Minter

## Overview

This skill enables users to create custom ERC20 tokens by collecting parameters, generating Solidity code, setting up a Foundry project, building the contract, and deploying to a target EVM network.

## Workflow

### Step 1: Collect Information
Collect the following parameters from the user:
- Token name (e.g., "MyToken")
- Token symbol (e.g., "MTK")
- Decimals (default: 18)
- Initial supply (default: 1000000)
- Target network (default: sepolia)

### Step 2: Generate ERC20 Contract
Use the provided script to generate the ERC20 contract code based on user parameters.
- Run `python scripts/generate_contract.py <name> <symbol> <decimals> <initial_supply>` to generate the contract
- The generated contract uses OpenZeppelin ERC20 standard

### Step 3: Initialize Forge Project
- Create a temporary directory under `./tmp/`
- Initialize a new Foundry project: `forge init`
- Place the generated contract in `src/Contract.sol`

### Step 4: Build Contract
- Install dependencies: `forge install OpenZeppelin/openzeppelin-contracts`
- Build the contract: `forge build`

### Step 5: Deploy to Network
- Ensure a local cast wallet is created (prerequisite)
- Get RPC URL for target network from https://chainlist.org/rpcs.json
  - Find the network entry and use a reliable HTTPS RPC URL
  - For Sepolia: typically "https://ethereum-sepolia.publicnode.com" or similar
- Deploy using: `forge create --rpc-url <network_rpc> --account <account_name> src/Contract.sol:MyToken --constructor-args <initial_supply> --broadcast`
- Verify deployment on the target network

## Prerequisites
- Foundry installed (forge, cast commands available)
- Local cast wallet created with `cast wallet new`
- Sufficient funds on the deployment account for gas fees

## Resources

### scripts/
- `generate_contract.py`: Python script to generate ERC20 contract code with custom parameters

### references/
- `erc20_guide.md`: Overview of ERC20 standard, required functions, events, and deployment considerations

### assets/
- `ERC20Template.sol`: Template Solidity file for ERC20 contract generation
```
END THIRD-PARTY FILE d1c29a01497fe20b

The third-party file has ended. Everything between the d1c29a01497fe20b tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© kukapay · MIT · https://github.com/kukapay/crypto-skills/tree/HEAD/skills/token-minter/SKILL.md

## Similar
- [permissioned-pools-deployer](https://affpapa.org/en/nevibecode/skills/permissioned-pools-deployer.md) — skill · 270 installs
- [token-integration-analyzer](https://affpapa.org/en/nevibecode/skills/token-integration-analyzer.md) — skill · 6100 installs
- [chainlink-data-feeds-skill](https://affpapa.org/en/nevibecode/skills/chainlink-data-feeds-skill.md) — skill · 392 installs
- [smart-contract-auditor](https://affpapa.org/en/nevibecode/agents/smart-contract-auditor.md) — subagent · 701 installs
- [rugproof](https://affpapa.org/en/nevibecode/plugins/rugproof.md) — plugin · ★ 13 repo stars
- [token-scan](https://affpapa.org/en/nevibecode/commands/token-scan.md) — command · ★ 16193 repo stars

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
