Files
next.js/skills/next-compile/SKILL.md
Jude GaoandGitHub e75d006d72 Bundle skills/ directory into next/dist/skills (#92493)
Experimenting with the notion of a "bundled skill" — agent skills
shipped directly in the `next` package under `next/dist/skills/<name>/`.

The first bundled skill is `next-compile`, which calls the dev server's
`get_compilation_issues` MCP tool to check compilation errors. Bundling
(rather than shipping as a standalone plugin) fits here because the
skill is coupled to Next.js implementation details — the `/_next/mcp`
endpoint and the tool schema — so shipping it in lockstep with the
`next` version that exposes them keeps them in sync.
2026-04-08 17:29:37 +00:00

748 B

name, description
name description
next-compile Check Next.js compilation errors via a running dev server. Turbopack only. MANDATORY after every code edit before reporting work complete. Replaces `next build`.

Check Next.js compilation errors

MANDATORY: after any Edit/Write, run step 2 before telling the user the change is done. Never run next build. Turbopack only — the script bails on webpack.

  1. Find the port of a running next dev — check listening processes. If you can't find it, ask the user.

  2. Run:

    node ./scripts/check.mjs <port>
    
  3. Fix actionable errors. Ignore noise or pre-existing unrelated failures.

  4. Only report the edit complete once step 2 returns clean (or only pre-existing failures).