Next.js and Turbopack Guide
Helps the agent work with Next.js 16+ dev builds, Turbopack caching, and bundle-size questions
- Repository
- affaan-m/ECC
- Stars
- 295,127
- Licence
- MIT
- Files
- 1 file
What it does
When installed, the agent gets guidance on Next.js 16 and later: that Turbopack is the default bundler for local development, when to switch back to webpack, how the filesystem cache speeds up restarts, and that middleware is named proxy.ts in Next.js 16 rather than middleware.ts. It is reference knowledge that shapes the agent's answers and suggestions; it does not run anything by itself.
Great for
- Developers building or debugging Next.js 16+ apps who see slow dev startup or hot reload
- Teams deciding whether to keep or disable Turbopack for a project
- Anyone reviewing a Next.js 16 project and wondering whether proxy.ts is a mistake
Skip it if
- Projects on Next.js versions before 16 without checking the version first, since the file naming and defaults differ and the agent may give wrong advice
- Non-developers or people who do not use Next.js, because the content is specific to that framework
Try asking
- “Why is my next dev server taking so long to start? Check whether Turbopack is in use.”
- “Should I switch this Next.js 16 project back to webpack for a plugin I depend on?”
- “Help me find heavy dependencies in my production bundle for Next.js 16.1.”
Install in 3 steps
- 1
Download the skill
The ZIP contains the 1 original files, the MIT licence and an attribution note.
nextjs-turbopack.zip - 2
Add it to your agent
Claude Code (all projects)
mkdir -p ~/.claude/skills && unzip nextjs-turbopack.zip -d ~/.claude/skills/Claude Code / Agent SDK (this project only)
mkdir -p .claude/skills && unzip nextjs-turbopack.zip -d .claude/skills/Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.
- 3
Ask for the task
No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.
Get better results
- State your Next.js version up front, since several behaviours (build bundler, Bundle Analyzer flags, --webpack vs --no-turbopack) depend on it.
- The skill itself defers to official Next.js docs for exact flags; check those before changing config.
- Do not let the agent rename proxy.ts to middleware.ts on Next.js 16 projects; the skill says this would break middleware.
What's inside
- SKILL.md
Redistributed unmodified from affaan-m/ECC under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.