К основному содержанию
скилл CX Codex

env-setup-wizard — скилл для Claude Code: что делает и как установить

Скилл env-setup-wizard настраивает файлы .env, создаёт типобезопасные схемы валидации через Zod и защищает проект от утечки секретов в git.

MIT 308 установок ★ 440 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add OneWave-AI/claude-skills --skill env-setup-wizard -a claude-code
Открыть на GitHub

Что делает env-setup-wizard

Скилл организует переменные окружения в проекте. Он раскладывает конфигурацию по уровням (.env, .env.example, .env.local), добавляет правила в .gitignore и создаёт единую точку входа для настроек вроде DATABASE_URL или токенов авторизации.

Вместо прямого обращения к process.env скилл генерирует модуль валидации на базе Zod. Если нужной переменной нет или формат строки нарушен, приложение завершает работу на старте с понятной ошибкой в консоли. Для Next.js предусмотрено разделение на серверные и клиентские переменные с префиксом NEXT_PUBLIC_, а также вариант на @t3-oss/env-nextjs.

Скилл заставляет объявить типы сразу: без TypeScript и установленного пакета Zod сгенерированный код валидации запустить не получится.

Какие задачи решает

  • Составить шаблон .env.example и правила для .gitignore
  • Настроить строгую проверку переменных окружения через Zod
  • Разделить клиентские и серверные переменные в Next.js
  • Заблокировать запуск приложения при неполной конфигурации

Примеры запросов агенту

  • Настрой переменные окружения для проекта на Next.js с базой данных Postgres и авторизацией
  • Сгенерируй файл .env.example и создай схему Zod для валидации конфигурации на старте
  • Раздели клиентские и серверные ключи API в src/lib/env.ts

Как установить env-setup-wizard

1Через Skills CLI (Vercel)

npx skills add OneWave-AI/claude-skills --skill env-setup-wizard -a claude-code

2Вручную: положить файлы

~/.claude/skills/env-setup-wizard/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/env-setup-wizard/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об env-setup-wizard

Как установить env-setup-wizard в Claude Code?

Выполните команду в терминале: npx skills add OneWave-AI/claude-skills --skill env-setup-wizard -a claude-code.

Что делает скилл env-setup-wizard?

Он проектирует структуру .env-файлов, готовит чистый .env.example без секретов и пишет скрипт проверки параметров через Zod.

Как скилл разделяет переменные в Next.js?

Для клиентской части проверяются переменные с префиксом NEXT_PUBLIC_, а ключи базы данных и секреты токенов остаются в серверной схеме.

Исходный текст

SKILL.md · MIT
---
name: env-setup-wizard
description: Set up environment variables, .env files, and configuration management. Use when configuring environment variables, creating .env files, or managing app configuration.
---

# Environment Setup Wizard

## Instructions

When setting up environment configuration:

1. **Identify required variables** for the project
2. **Create .env structure** with proper organization
3. **Set up type-safe access** to env vars
4. **Add validation** on startup
5. **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

```bash
# ===================
# 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

# ===================
# Third-party APIs
# ===================
# Get from: https://stripe.com/dashboard
STRIPE_SECRET_KEY=
STRIPE_PUBLISHABLE_KEY=
STRIPE_WEBHOOK_SECRET=

# Get from: https://resend.com
RESEND_API_KEY=

# ===================
# Storage
# ===================
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_REGION=us-east-1
S3_BUCKET_NAME=
```

## Type-Safe Environment (Zod)

```typescript
// src/lib/env.ts
import { z } from 'zod';

const envSchema = z.object({
  // App
  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
  APP_URL: z.string().url(),
  PORT: z.coerce.number().default(3000),

  // Database
  DATABASE_URL: z.string().min(1),

  // Auth
  JWT_SECRET: z.string().min(32),
  NEXTAUTH_SECRET: z.string().min(32),
  NEXTAUTH_URL: z.string().url(),

  // APIs (optional in dev)
  STRIPE_SECRET_KEY: z.string().optional(),
  RESEND_API_KEY: z.string().optional(),
});

// Validate on import
const parsed = envSchema.safeParse(process.env);

if (!parsed.success) {
  console.error('Invalid environment variables:');
  console.error(parsed.error.flatten().fieldErrors);
  process.exit(1);
}

export const env = parsed.data;

// Type export for use elsewhere
export type Env = z.infer<typeof envSchema>;
```

## Next.js Specific

```typescript
// src/lib/env.ts for Next.js
import { z } from 'zod';

// Server-side variables
const serverSchema = z.object({
  DATABASE_URL: z.string(),
  JWT_SECRET: z.string(),
});

// Client-side variables (must start with NEXT_PUBLIC_)
const clientSchema = z.object({
  NEXT_PUBLIC_APP_URL: z.string().url(),
  NEXT_PUBLIC_STRIPE_KEY: z.string(),
});

export const serverEnv = serverSchema.parse(process.env);
export const clientEnv = clientSchema.parse({
  NEXT_PUBLIC_APP_URL: process.env.NEXT_PUBLIC_APP_URL,
  NEXT_PUBLIC_STRIPE_KEY: process.env.NEXT_PUBLIC_STRIPE_KEY,
});
```

## T3 Env (Recommended for Next.js)

```typescript
// src/env.mjs
import { createEnv } from "@t3-oss/env-nextjs";
import { z } from "zod";

export const env = createEnv({
  server: {
    DATABASE_URL: z.string().url(),
    NODE_ENV: z.enum(["development", "test", "production"]),
  },
  client: {
    NEXT_PUBLIC_APP_URL: z.string().url(),
  },
  runtimeEnv: {
    DATABASE_URL: process.env.DATABASE_URL,
    NODE_ENV: process.env.NODE_ENV,
    NEXT_PUBLIC_APP_URL: process.env.NEXT_PUBLIC_APP_URL,
  },
});
```

## .gitignore

```gitignore
# Environment files
.env
.env.local
.env.*.local

# Keep example
!.env.example
```

## Security Best Practices

1. **Never commit secrets** to git
2. **Use different values** per environment
3. **Rotate secrets regularly**
4. **Use secret managers** in production (Vault, AWS Secrets Manager)
5. **Validate on startup** to fail fast
6. **Prefix client vars** (NEXT_PUBLIC_, VITE_, REACT_APP_)

© OneWave-AI · MIT · OneWave-AI/claude-skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
env-secrets-manager patricio0312rev Скилл env-secrets-manager помогает разложить ключи и переменные окружения по местам: что коммитить в .env.example, что держать в AWS Secrets Manager, как проверить конфиг при старте. CX Codex +1 289установок env-manager bobmatnyc Скилл env-manager проверяет .env, ищет секреты в клиентских переменных и сравнивает файл с .env.example. Пригодится перед деплоем и при онбординге. CX Codex +1 358установок audit-env-variables qdhenry Скилл audit-env-variables проверяет переменные окружения в JS/TS-проекте: находит неиспользуемые, распознаёт сервисы по именам и показывает, где в коде каждая переменная задействована. CX Codex +1 ★ 1 357звёзд репо vercel-env-sync davila7 Команда vercel-env-sync синхронизирует переменные окружения между локальными файлами .env и проектом на Vercel через Vercel CLI. Помогает выгружать, пушить и проверять секреты. CX Codex +1 406установок 05-env-and-auth codeaashu Промпт 05-env-and-auth настраивает переменные окружения и проверяет доступ к API в проекте claude-code. Помогает собрать .env.example и подготовить тестовый запуск через Bun. GP ChatGPT ★ 3 444звёзд репо form-wizard-builder patricio0312rev Скилл form-wizard-builder собирает многошаговые формы: схемы валидации, шаги, общее состояние, индикатор прогресса и шаг проверки перед отправкой. CX Codex +1 344установок

Из того же набора185

Весь набор →
error-boundary-creator Скилл error-boundary-creator создаёт предохранители ошибок, запасные интерфейсы и перехват сбоев для React и Next.js. Помогает изолировать падения сторонних библиотек и настроить логирование. CX Codex +1 316установок docker-debugger Скилл docker-debugger для Claude Code разбирает сбои сборки и запуска контейнеров, проблемы сети и томов, настройки docker-compose. Находит причины ошибок и предлагает исправления конфигурации. CX Codex +1 314установок scout Скилл scout для Claude Code разбирает текущий диалог и рекомендует скилл или субагента для задачи. Помогает выбрать инструмент среди десятков команд. CX Codex +1 314установок test-coverage-improver Скилл test-coverage-improver находит пробелы в покрытии тестами и генерирует недостающие тесты для критичных участков кода. CX Codex +1 312установок client-proposal-generator Скилл client-proposal-generator для Claude Code собирает из брифа проект коммерческого предложения в proposal.md с планом работ и вариантами цены. Готовит предложение под конкретного клиента. CX Codex +1 301установок security-pentest-planner Скилл security-pentest-planner строит план пентеста веб-приложения: анализирует код, маршруты API, аутентификацию и конфиги инфраструктуры, генерирует pentest-plan.md с конкретными тест-кейсами. CX Codex +1 297установок tech-due-diligence Скилл tech-due-diligence читает код компании, которую вы покупаете или в которую инвестируете, и пишет отчёт tech-dd-report.md с оценкой рисков и рекомендацией go/no-go. CX Codex +1 294установок workflow-automator Скилл workflow-automator разбирает ручной бизнес-процесс и проектирует его автоматизированную версию. На выходе — документ с диаграммами, рекомендациями по инструментам и этапами внедрения. CX Codex +1 285установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой