runtime-debug

Diagnose runtime bundle and module-resolution regressions in Next.js projects.

142k|31.7k|Updated Oct 5, 2016
One-click install
npx skills add https://github.com/vercel/next.js --skill runtime-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: runtime-debug
Source: https://github.com/vercel/next.js/tree/main/.agents/skills/runtime-debug
Command: npx skills add https://github.com/vercel/next.js --skill runtime-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reproduce and diagnose runtime-bundle and module-resolution regressions in Next.js projects, enabling faster root-cause analysis and stabilization.

Core Features & Use Cases

  • CI mirroring and environment parity for reproducible failures.
  • Full stack traces visibility and route trace inspection to pinpoint issues.
  • Webpack stats diffing to compare builds and identify surprising inclusions.

Quick Start

Reproduce the regression in a controlled CI-like environment using the provided debug workflow.

Frequently Asked Questions about runtime-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose Next.js runtime bundle and module-resolution regressions?

Diagnose Next.js runtime bundle and module-resolution regressions by reproducing the issue in a controlled CI-like environment to enable faster root-cause analysis and stabilization.

Why does my Next.js build fail in CI with unexpected module inclusions?

Unexpected module inclusions and CI failures are diagnosed using webpack stats diffing to compare builds and identify surprising inclusions causing the regressions.

Can I inspect full stack traces and route traces for Next.js production builds?

Yes, you can inspect full stack traces visibility and route trace inspection across both Next.js development and production builds to pinpoint runtime issues.

What's the best way to compare Next.js webpack stats to find bundle-size regressions?

The best way to find bundle-size regressions is using webpack stats diffing, which compares builds to identify surprising inclusions and environment-specific traces.

How do I reproduce environment-specific Next.js runtime failures locally?

Reproduce environment-specific Next.js runtime failures locally through CI mirroring and environment parity, ensuring controlled reproduction of the regression.

What are the limitations of diagnosing Next.js bundle issues without CI mirroring?

Without CI mirroring, diagnosing Next.js bundle issues lacks environment parity, making it difficult to reproduce CI failures and trace unexpected module inclusions accurately.