Env Setup Wizard

This walks you through setting up environment variables properly with type safety and validation. It creates the full .env file structure you need (development, production, example files), then adds Zod schemas to catch missing or invalid variables on startup instead of at runtime. Includes ready to use templates for common services like Stripe and database URLs, organized by category with comments on where to get API keys. The T3 env approach for Next.js is especially clean since it enforces the server/client split at the type level. Good for onboarding new projects or fixing that mess where half your team has different .env files and nobody knows what's actually required.

skills.sh installs: 303
GitHub stars: 422
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add onewave-ai/claude-skills --skill env-setup-wizard --agent claude-code

Installs into .claude/skills of the current project.

Files

Environment Setup Wizard

Instructions

When setting up environment configuration:

Identify required variables for the project
Create .env structure with proper organization
Set up type-safe access to env vars
Add validation on startup
Document all variables

File Structure

project/
├── .env                  # Local development (git-ignored)
├── .env.example          # Template (committed to git)
├── .env.local            # Local overrides (git-ignored)
├── .env.development      # Development defaults
├── .env.production       # Production defaults
└── src/
    └── lib/
        └── env.ts        # Type-safe env access

.env.example Template

# ===================
# Application
# ===================
NODE_ENV=development
APP_URL=http://localhost:3000
PORT=3000

# ===================
# Database
# ===================
DATABASE_URL=postgresql://user:password@localhost:5432/dbname

# ===================
# Authentication
# ===================
# Generate with: openssl rand -base64 32
JWT_SECRET=
NEXTAUTH_SECRET=
NEXTAUTH_URL=http://localhost:3000

SKILL.md on GitHub

Details

Repository: github.com/onewave-ai/claude-skills
First seen: Jun 3, 2026