# nextjs

Раскладывает переменные окружения Next.js по файлам .env* и объясняет, какое значение победит при запуске, сборке и деплое.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 212 установок · ★ 80 у репозитория
- Автор: bobmatnyc
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/bobmatnyc/claude-mpm-skills/tree/HEAD/toolchains/javascript/frameworks/nextjs/SKILL.md
- Обновлён: 2026-07-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/bobmatnyc-nextjs

## Что делает

Скилл описывает, как Next.js раскладывает переменные по файлам `.env*`: `.env`, `.env.local`, `.env.development`, `.env.production` и их `.local`-версии. Приоритет идёт сверху вниз: `.env.$(NODE_ENV).local`, `.env.local` (в тестах не читается), `.env.$(NODE_ENV)`, общий `.env`. Если `DATABASE_URL` задан в двух файлах, победит более специфичный.

Дальше про типы. Всё с префиксом `NEXT_PUBLIC_` уезжает в браузер, остальное живёт только на сервере: в API-роутах и `getServerSideProps`. Секрет в `NEXT_PUBLIC_*` прочитает любой, кто откроет devtools. Публичные значения вшиваются в бандл на этапе сборки, поэтому после правки их в панели Vercel нужен `vercel --prod`: без редеплоя в браузере останутся старые.

Внутри есть примеры `.env`, `.env.local`, `.env.production` и `.env.example`, а ещё порядок проверки: `python scripts/validate_env.py .env.local --framework nextjs`, сравнение с `.env.example`, скан утечек через `python scripts/scan_exposed.py --check-gitignore` и синхронизация с Vercel через `python scripts/sync_secrets.py --platform vercel --sync --dry-run`. Скриптам нужен Python.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bobmatnyc/claude-mpm-skills --skill nextjs -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/nextjs/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/nextjs/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bobmatnyc/claude-mpm-skills --skill nextjs -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/nextjs/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bobmatnyc/claude-mpm-skills --skill nextjs -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/nextjs/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bobmatnyc/claude-mpm-skills toolchains/javascript/frameworks/nextjs
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/nextjs/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bobmatnyc/claude-mpm-skills --skill nextjs -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/bobmatnyc/claude-mpm-skills --path toolchains/javascript/frameworks/nextjs
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/nextjs/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add bobmatnyc/claude-mpm-skills --skill nextjs -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/bobmatnyc/claude-mpm-skills/tree/HEAD/toolchains/javascript/frameworks/nextjs/SKILL.md

## Когда брать
- разложить переменные по `.env`, `.env.local` и `.env.production` без путаницы
- понять, какой файл перебьёт значение в продакшене
- убрать секреты из `NEXT_PUBLIC_*` до сборки
- сверить `.env.local` с `.env.example` перед деплоем
- перегнать локальные секреты в переменные Vercel

## Примеры запросов агенту
- Разложи переменные окружения Next.js по файлам: что в `.env`, что в `.env.local`, что в `.env.production`.
- Почему в проде подхватился `DATABASE_URL` из `.env`, а не из `.env.production.local`?
- Прогони `scripts/validate_env.py` по `.env.local` и сравни результат с `.env.example`.

## Похожие
- [vercel-env-sync](https://affpapa.org/nevibecode/commands/vercel-env-sync.md) — команда · 406 установок
- [vercel-environment-sync](https://affpapa.org/nevibecode/hooks/vercel-environment-sync.md) — хук · 363 установки
- [nextjs-on-cloudflare](https://affpapa.org/nevibecode/skills/nextjs-on-cloudflare.md) — скилл · 60100 установок
- [nextjs-deployment](https://affpapa.org/nevibecode/skills/nextjs-deployment.md) — скилл · 3900 установок
- [vercel-deployment](https://affpapa.org/nevibecode/skills/sickn33-vercel-deployment.md) — скилл · 1800 установок
- [vercel-deployments](https://affpapa.org/nevibecode/skills/vercel-deployments.md) — скилл · 351 установка

## Другие версии с тем же именем
- [nextjs · openai](https://affpapa.org/nevibecode/skills/nextjs.md) — 50 установок
- [nextjs · pproenca](https://affpapa.org/nevibecode/skills/pproenca-nextjs.md) — 1200 установок
- [nextjs · pymodel](https://affpapa.org/nevibecode/skills/pymodel-nextjs.md) — 621 установка
- [nextjs · secondsky](https://affpapa.org/nevibecode/skills/claude-skills-maintainers-nextjs.md) — 299 установок
- [nextjs · ulpi-io](https://affpapa.org/nevibecode/skills/ulpi-io-nextjs.md) — 182 установки

Из того же набора: [bobmatnyc/claude-mpm-skills](https://affpapa.org/nevibecode/by/bobmatnyc/claude-mpm-skills.md) — 143 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
