next-dev-loop

Verify Next.js runtime behavior after code edits using /_next/mcp and agent-browser.

Updated Sep 16, 2026
One-click install
npx skills add https://github.com/jasonviipers/vipers --skill next-dev-loop-jasonviipers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-dev-loop
Source: https://github.com/jasonviipers/vipers/tree/main/.agents/skills/next-dev-loop
Command: npx skills add https://github.com/jasonviipers/vipers --skill next-dev-loop-jasonviipers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires agent-browser.

What problem does it solve? Code that compiles and type-checks can still fail at runtime. This Skill closes that gap by verifying every edit against a live next dev server, cross-checking Next.js's own introspection endpoint with a real browser session so you confirm actual behavior, not just build health. ## Core Features & Use Cases - Dual-view verification: Combines the /_next/mcp endpoint (routes, RSC, server actions, compilation issues, server-side errors) with agent-browser (DOM, console, network, React fiber, render counts) to cross-check the same running app. - Structured preflight and loop: Enforces version floors (Next.js 16.3+ with Turbopack, agent-browser >= 0.31.1), probes tool availability, then runs an edit/verify cycle covering compilation, runtime errors, user-visible behavior, and React-level rendering. - Session-persistent browser testing: Uses worktree-scoped session ids with cookie/storage restore so authenticated pages stay logged in across verification loops. - Use Case: After editing a server component, confirm via get_compilation_issues that Turbopack compiled cleanly, check get_errors for runtime failures, then drive the page in a real Chrome session to assert the user actually sees the updated UI. ## Quick Start Verify my last edit to the dashboard route actually works in the running Next.js dev server, checking both compilation and what renders in the browser.

Frequently Asked Questions about next-dev-loop

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

FAQPage Schema
How do I verify Next.js changes work at runtime, not just compile?

Run the edit/verify loop against a live next dev server: check get_compilation_issues on the /_next/mcp endpoint for build health, get_errors for runtime failures, then drive the page with agent-browser to assert what users actually see in the DOM and React tree.

What is the /_next/mcp endpoint in Next.js?

It is an HTTP endpoint Next.js 16.3+ exposes about itself during development, listing tools like get_routes, get_errors, get_page_metadata, and get_compilation_issues. Call tools/list to discover the current surface; replies are SSE, so parse the data: line.

Does this workflow require Turbopack or work with webpack?

Turbopack is required. The get_compilation_issues tool returns a "Turbopack project is not available" error on webpack, and preflight refuses to continue. Next.js 16.3 or later with Turbopack is a hard floor.

Why does agent-browser return a blank page or no session error?

A blank read or "no browser session" error usually means a stale browser session, not a broken route. Reopen with the same --session and --restore flags, or close and reopen the session. Avoid falling back to curl, which bypasses the browser under test.

Can I use this with an older Next.js version?

No. Next.js below 16.3 lacks the /_next/mcp endpoint and the get_compilation_issues tool, so preflight refuses and instructs you to upgrade via pnpm next upgrade or npx next upgrade before continuing.