env-setup-wizard — скилл для Claude Code: что делает и как установить
Скилл env-setup-wizard настраивает файлы .env, создаёт типобезопасные схемы валидации через Zod и защищает проект от утечки секретов в git.
MIT 308 установок ★ 440 обновлён 2026-10-20
npx skills add OneWave-AI/claude-skills --skill env-setup-wizard -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/env-setup-wizard/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/env-setup-wizard/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill env-setup-wizard -a codex2Вручную: положить файлы
.agents/skills/env-setup-wizard/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill env-setup-wizard -a cursor2Вручную: положить файлы
.cursor/skills/env-setup-wizard/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OneWave-AI/claude-skills env-setup-wizard2Вручную: положить файлы
.github/skills/env-setup-wizard/SKILL.md1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill env-setup-wizard -a gemini-cli2Командой платформы
gemini skills install https://github.com/OneWave-AI/claude-skills --path env-setup-wizardВручную: положить файлы
.devin/skills/env-setup-wizard/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill env-setup-wizard -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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