# next-best-practices

Скилл с набором правил Next.js: файловые конвенции, границы RSC, async API, метаданные, обработка ошибок. Пригодится, когда агент пишет или ревьюит код на Next.js.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 383 установки · ★ 643
- Автор: pedronauck
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/pedronauck/skills/tree/HEAD/skills/curated/next-best-practices/SKILL.md
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/skills/next-best-practices

## Что делает

Скилл включается, когда агент пишет или проверяет код Next.js, и подсказывает ему, как правильно. Внутри — набор справочных файлов по темам: структура проекта и специальные файлы, динамические и catch-all сегменты маршрутов, параллельные и перехватывающие маршруты. Отдельно разобрано переименование middleware в v16.

Есть разделы про границы React Server Components: как отловить async-клиентский компонент, несериализуемые пропсы, исключения в Server Actions. Дальше — async-паттерны Next.js 15+, включая асинхронные `params`, `searchParams`, `cookies()` и `headers()`, и кодмод для миграции. Про выбор рантайма сказано коротко: по умолчанию Node.js, Edge — когда он уместен.

Остальные файлы закрывают обработку ошибок (`error.tsx`, `global-error.tsx`, `not-found.tsx`, `redirect`, `notFound`, `forbidden`, `unauthorized`), паттерны работы с данными и борьбу с водопадами через `Promise.all` и Suspense, route handlers, метаданные и OG-картинки через `next/og`, оптимизацию изображений и шрифтов, бандлинг, скрипты, ошибки гидратации, Suspense-границы и self-hosting с `output: 'standalone'`. Скилл не вызывается вручную: в его настройках стоит `user-invocable: false`, поэтому он подхватывается сам в подходящем контексте.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill next-best-practices -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill next-best-practices -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill next-best-practices -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pedronauck/skills next-best-practices
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill next-best-practices -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pedronauck/skills --path skills/curated/next-best-practices
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill next-best-practices -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/pedronauck/skills/tree/HEAD/skills/curated/next-best-practices/SKILL.md

## Когда брать
- поймать async-клиентский компонент до того, как он сломает сборку
- перевести проект на асинхронные `params` и `cookies()` в Next.js 15+
- разобраться, когда нужен route handler, а когда Server Action
- убрать водопад запросов через `Promise.all` и Suspense
- настроить OG-картинки и метаданные без ручных тегов

## Примеры запросов агенту
- Проверь этот компонент на корректные границы RSC и скажи, что не так
- Перепиши страницу под асинхронные `params` и `searchParams`
- Почему у меня ошибка гидратации в этом компоненте?

## Похожие
- [frontend-design](https://affpapa.org/nevibecode/skills/frontend-design.md) — скилл · 1025790 установок
- [design-taste-frontend](https://affpapa.org/nevibecode/skills/design-taste-frontend.md) — скилл · 678700 установок
- [prototype](https://affpapa.org/nevibecode/skills/prototype.md) — скилл · 986201 установка
- [hyperframes](https://affpapa.org/nevibecode/skills/heygen-com-hyperframes.md) — скилл · 1200000 установок
- [hyperframes-cli](https://affpapa.org/nevibecode/skills/heygen-com-hyperframes-cli.md) — скилл · 1300000 установок
- [webapp-testing](https://affpapa.org/nevibecode/skills/webapp-testing.md) — скилл · 186758 установок

Из того же набора: [pedronauck/skills](https://affpapa.org/nevibecode/by/pedronauck/skills.md) — 18 карточек

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