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

nextjs-bundle-optimizer — скилл для Claude Code: анализ сборки

Скилл nextjs-bundle-optimizer для Claude Code измеряет размер бандла и время сборки Next.js и помогает проверять оптимизации по одной. Проверяет оптимизации при росте First Load JS или замедлении сборки.

MIT 152 установок ★ 227 обновлён 2026-08-15

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

Что делает nextjs-bundle-optimizer

Скилл снимает базовые показатели, ищет крупные модули и сопоставляет их с рецептами оптимизации. После одного изменения он повторно собирает проект, сравнивает результат с базой и проверяет сборку, типы и тесты. Если проверка проходит и есть улучшение, рабочий шаг фиксируется коммитом; при сбое или отсутствии выигрыша его можно отменить.

Для Next.js 16 используется next experimental-analyze; в Turbopack часть оптимизаций выполняется автоматически. Для Next.js 15 и более ранних версий в режиме webpack предусмотрен @next/bundle-analyzer. До начала нужны git, jq в PATH и чистое рабочее дерево — иначе проверки с контрольными точками не соответствуют описанному процессу. Первоначальную настройку запускают из корня приложения: bash scripts/baseline.sh --setup.

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

  • найти крупные модули, раздувающие First Load JS
  • определить причину медленной production-сборки
  • сравнить размер бандла до и после изменения
  • проверить оптимизацию сборкой, проверкой типов и тестами
  • откатить изменение, если оно вызвало регрессию

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

  • Найди, какие модули сильнее всего увеличивают First Load JS в этом приложении Next.js.
  • Сравни время production-сборки до и после моего изменения и проверь, не появились ли регрессии.
  • Разбери вывод next experimental-analyze и предложи один рецепт оптимизации для самого крупного модуля.

Как установить nextjs-bundle-optimizer

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill nextjs-bundle-optimizer -a claude-code

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

~/.claude/skills/nextjs-bundle-optimizer/SKILL.md

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

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

Вопросы о nextjs-bundle-optimizer

Как установить nextjs-bundle-optimizer в Claude Code?

Выполните npx skills add pproenca/dot-skills --skill nextjs-bundle-optimizer -a claude-code. Файл скилла находится по пути ~/.claude/skills/nextjs-bundle-optimizer/SKILL.md.

Что делает nextjs-bundle-optimizer?

Он измеряет бандлы и время сборки Next.js, помогает выбрать одну оптимизацию и проверяет её результат сборкой, проверкой типов и тестами.

Что нужно подготовить перед запуском?

Нужны git, jq в PATH и чистое рабочее дерево. Для настройки из корня приложения запустите bash scripts/baseline.sh --setup.

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

SKILL.md · MIT
---
name: nextjs-bundle-optimizer
description: "Next.js 16 bundle-size and build-time optimization — runs a data-driven iteration loop: measure baseline → analyze top offenders → apply ONE recipe → re-measure → verify nothing broke (build + types + tests + no regression) → commit or revert. Built for Next.js 16 with Turbopack default, and falls back to webpack-mode tooling when the project hasn't migrated yet. Triggers on phrases like \"First Load JS is huge\", \"bundle size\", \"build takes too long\", \"page is slow to TTI\", \"reduce bundle\", \"tree-shake\", or when the user shares output from `next experimental-analyze` / `@next/bundle-analyzer` — even if the user doesn't say \"optimize\" explicitly."
---
# Next.js Bundle & Build-Time Optimizer

Data-driven optimization loop for Next.js 16 applications. The skill orchestrates `next experimental-analyze`, builds, type checks, and tests to make verifiable improvements one change at a time.

## When to Apply

Use this skill when:
- The user wants to reduce bundle size / First Load JS / route bundles in a Next.js 16 app.
- Production builds are slow and the user wants to diagnose and fix the bottleneck.
- The user shares analyzer output, a screenshot of the treemap, or asks "why is `<X>` so big?"
- A new dependency was added and bundles grew — they want to understand why and unwind it.
- The user wants to set a performance budget and enforce it iteratively.

## Why iterative (not "apply all optimizations at once")

Bundle optimization is full of foot-guns. Examples:
- Moving a "client-only" dep behind `next/dynamic` can break SSR consumers that depended on its presence at first paint.
- `experimental.optimizePackageImports` with the wrong package can mis-resolve subpath exports.
- Aggressive `modularizeImports` regex rewrites can hit unintended modules.
- Narrowing the polyfill target can break older mobile browsers in production.

The only reliable way is: **one change, measure, verify, commit (or revert)**. This skill enforces that discipline through scripts.

## Prerequisites

- Next.js 16+ project (the skill auto-detects from `package.json`).
- `git` (the workflow uses commits as checkpoints and revert as rollback).
- `jq` available on PATH (used by analyze/compare scripts).
- A clean working tree before starting (the verify step uses `git status` to confirm).
- For projects still on Next.js 15 or earlier in webpack mode: the skill detects this and uses `@next/bundle-analyzer` instead of `experimental-analyze`. See [gotchas.md](gotchas.md).

## Setup

On first use, run:

```bash
bash scripts/baseline.sh --setup
```

This walks through `config.json` interactively. If `config.json` already has values, scripts use those and skip the prompts.

## Workflow Overview

```
┌── 1. baseline ──┐   Clean build, snapshot bundles + timing → baselines/{timestamp}/
│                 │
│   2. analyze ───┤   Run `next experimental-analyze --output`, extract top offenders
│                 │
│   3. diagnose ──┤   Map each offender to a recipe in references/optimizations.md
│                 │
│   ── apply ─────┤   User (or agent) applies ONE recipe. Skill helps draft the change.
│                 │
│   4. measure ───┤   Re-build, re-analyze, save to iterations/{n}/
│                 │
│   5. compare ───┤   Diff vs baseline; flag regressions; print delta table
│                 │
│   6. verify ────┤   Build + tsc + tests + no overall regression. Hard PASS/FAIL.
│                 │
│   commit OR ────┘   `git commit` (PASS+improvement) or `git revert` (FAIL/no win)
│   revert
│
└── loop back to step 2 with new baseline if you want a fresh measurement point.
```

Read [references/workflow.md](references/workflow.md) for the detailed loop with error handling, rollback procedures, and what each script's output looks like.

## Quick Reference

### Scripts (run from the Next.js app root)

| Script | Purpose | Output |
|--------|---------|--------|
| `scripts/baseline.sh` | Establish the reference point | `baselines/{ts}/{bundle,timing,manifest}.json` |
| `scripts/analyze.sh` | Run analyzer, parse top offenders | `iterations/{n}/findings.json` |
| `scripts/diagnose.sh [findings.json]` | Map findings → recipes | stdout: prioritized recipe list |
| `scripts/measure.sh` | Re-measure after a change | `iterations/{n}/{bundle,timing}.json` |
| `scripts/compare.sh [baseline] [current]` | Diff snapshots | stdout: delta table; exit 1 on regression |
| `scripts/verify.sh` | Full verification | exit 0 = safe to commit, exit 1 = revert |

### Optimization Recipes

[references/optimizations.md](references/optimizations.md) catalogs recipes by analyzer signal:

**Bundle size**
- Barrel-import bloat → `experimental.optimizePackageImports` (webpack) / auto in Turbopack
- Heavy client lib pulled in on every route → `next/dynamic({ ssr: false })`
- Server-only lib imported from a client component → move to Server Component
- Duplicate dependency versions → dedupe via `overrides` / `resolutions`
- Polyfill bloat → tighten `browserslist`
- Per-icon imports for icon libraries

**Build time**
- Enable `experimental.turbopackFileSystemCacheForBuild`
- Narrow `transpilePackages` (overuse balloons compile time)
- Split `tsc --noEmit` from `next build` in CI
- Identify single-file bottlenecks with `NEXT_TURBOPACK_TRACING=1`

Each recipe documents: **signal → fix → expected impact → verify step**.

## Gotchas

See [gotchas.md](gotchas.md) for accumulated failure points. Initially seeded with the most common Next.js 16 traps:
- `next build` no longer prints First Load JS — don't grep build output for it.
- `optimizePackageImports` is a no-op under Turbopack (default in 16) — Turbopack auto-optimizes.
- Comparing build times needs cache state controlled — either delete `.next/` (cold) or pre-warm (warm).

## Related Skills

- `vercel:nextjs` — general Next.js App Router guidance; consult for refactoring decisions while applying recipes.
- `vercel:turbopack` — for build-time debugging beyond what this skill covers.
- `vercel:next-cache-components` — when a recipe touches caching boundaries.

© pproenca · MIT · pproenca/dot-skills

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

Все скиллы по теме «Фронтенд и UI» →
next-bundle-optimizer vercel Скилл next-bundle-optimizer для Claude Code и других агентов: аудирует начальную загрузку Next.js, находит медленные маршруты, раздутые клиентские бандлы и дублирующиеся зависимости. CX Codex +1 4 800установок nextjs-bundle-analyzer davila7 Слэш-команда nextjs-bundle-analyzer для Claude, которая разбирает размер бандла Next.js и подсказывает, что урезать. CX Codex +1 560установок nextjs-turbopack affaan-m Скилл nextjs-turbopack объясняет, как использовать Turbopack в Next.js 16+ и когда выбирать webpack. Пригодится при отладке медленного запуска, HMR и имени файла middleware. CX Codex +1 6 800установок plugin-bundle-size grafana Скилл plugin-bundle-size помогает уменьшить размер входного файла module.js в плагинах приложений Grafana через React.lazy и разделение чанков в Webpack. CX Codex +1 4 600установок bundle-size-optimization aj-geddes Скилл bundle-size-optimization помогает уменьшить размер JS и CSS бандлов через разделение кода и tree shaking. Пригодится при настройке сборки или после добавления тяжёлых зависимостей. CX Codex +1 569установок optimize-bundle-size BuildWithClaude Community Команда optimize-bundle-size для Claude Code и Cursor: разбирает бандл, находит тяжёлые зависимости, переписывает конфиг сборки — чанки, ленивая загрузка, tree shaking. Убирает лишний JS из страницы. CX Codex +1 ★ 3 785звёзд репо

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

Весь набор →
react-hook-form-audit Скилл react-hook-form-audit ищет 16 антипаттернов React Hook Form в проекте Next.js на App Router и пишет markdown-отчёт с номерами строк. Только чтение, код не меняет. CX Codex +1 158установок codex-goals Скилл codex-goals для Codex помогает формулировать и проверять долгосрочные цели: задавать измеримый результат, способ проверки и условие остановки. Описывает постановку многошаговых задач с понятным финалом. CX Codex +1 158установок expo-design-system Скилл expo-design-system для Claude Code помогает строить и проверять общие компоненты Expo и React Native для веба и iOS. Подключается при работе с токенами, темами и повторно используемым интерфейсом. CX Codex +1 156установок complexity-optimizer Скилл complexity-optimizer находит узкие места алгоритмической сложности в коде и готовит отчёт с безопасными исправлениями. CX Codex +1 156установок implementation-design-patterns Скилл implementation-design-patterns для Claude Code помогает определить паттерн Gang of Four по описанию задачи и понять, когда его применять или избегать. CX Codex +1 151установок better-auth Скилл по Better Auth для TypeScript: помогает поднять инстанс, выбрать адаптер, настроить сессии и перейти с другой auth-библиотеки. CX Codex +1 150установок diataxis Скилл diataxis раскладывает техническую документацию на четыре режима: туториал, инструкция, справочник, объяснение. Помогает решить, что писать на конкретной странице. CX Codex +1 149установок drizzle-sqlite-scaffold Скилл drizzle-sqlite-scaffold генерирует готовый boilerplate для Drizzle ORM + SQLite: конфиг, клиент с прагмами, схемы таблиц, CRUD-модули и валидаторы. Срабатывает на фразы вроде «добавь таблицу для X» или «настрой БД». CX Codex +1 149установок

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

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