next.js: Skill for Claude Code

.agents/skills/insight-error-page/SKILL.md

insight-error-page is a skill for Claude Code, Codex from vercel/next.js. It costs 83 tokens per session (4,994 once invoked), scanned A, original, MIT.

A guide for writing or checking an error page for the Next.js development overlay, the panel developers see when the framework reports a problem during development.

In plain words
What is it for?
Use it to create or audit an errors/*.mdx page, including its title, fix cards, copy-prompt button, snippets, and terminology.
Why use it?
It keeps the page's wording, fix cards, code examples, and links aligned with the actual error guidance shown by Next.js.

Skill for Claude CodeCodex ✓ vendor

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is vercel/next.js's own configuration. It tells Claude Code and Codex how to work on next.js itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything next.js configures →

About the project

Next.js is a React framework for building applications that run across the browser and Node.js, including server-rendered applications. It is used by developers building web applications with React components.

vercel/next.js · 143,076 stars · on GitHub · nextjs.org

Reuse

Borrowing it

Nothing to install: this file belongs to vercel/next.js. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/vercel/next.js/canary/.agents/skills/insight-error-page/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/vercel/next.js

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for insight-error-page

README.md
[![agentmods](https://agentmods.dev/badge/skills/vercel/next.js/insight-error-page/github.svg)](https://agentmods.dev/skills/vercel/next.js/insight-error-page)
Your own site
<a href="https://agentmods.dev/skills/vercel/next.js/insight-error-page"><img src="https://agentmods.dev/badge/skills/vercel/next.js/insight-error-page/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for insight-error-page

Your own site · 80×15
<a href="https://agentmods.dev/skills/vercel/next.js/insight-error-page"><img src="https://agentmods.dev/badge/skills/vercel/next.js/insight-error-page.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 83 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,994 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Snyk pass 6 Sept 2026
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 2 findings, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Prompt Injection · line 24
    Large whitespace padding was detected (a block of blank lines or a long run of spaces). This can push injected instructions below or to the right of the visible area so a human reviewer never sees them while the agent still reads them. Manual review of the hidden content is recommended.
    Fix: Remove the large whitespace padding (blank-line blocks or long space runs) and review any content hidden below or to the right of it. Keep skill files compact and reviewable so no instructions can be
  • medium Prompt Injection · line 24
    Large whitespace padding was detected (a block of blank lines or a long run of spaces). This can push injected instructions below or to the right of the visible area so a human reviewer never sees them while the agent still reads them. Manual review of the hidden content is recommended.
    Fix: Remove the large whitespace padding (blank-line blocks or long space runs) and review any content hidden below or to the right of it. Keep skill files compact and reviewable so no instructions can be
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00083 $0.04994
Opus 5.5 $0.00033 $0.01998
Sonnet 5.5 $0.00017 $0.00999
Haiku 4.5 $0.00008 $0.00499

Measured 1mo ago against content hash 106619cf59b1, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

insight-error-page scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/insight-error-page/SKILL.md · 251 lines

How it starts

The opening of the file, as written. The whole thing — 251 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Insight Error Page — Write & Audit

Write or audit an errors/<slug>.mdx insight-kind page that ships from this repo to nextjs.org and mirrors the fix-card set in the Next.js dev overlay.

Terminology: the frontmatter uses kind: insight but the body text calls these "errors" — never "insights". Write "this error", "error pages", "dismiss the error".

When to use this skill

  • Write mode: "create the error page for next-prerender-random", "write the sync IO docs"
  • Audit mode: "audit the blocking-prerender-dynamic page", "check the error pages match the framework"
  • Any task involving errors/*.mdx insight pages (frontmatter has kind: insight)

Source of truth chain

Every decision traces back to one of these. When in doubt, read the source — don't guess.

What Source file How to read it
Card titles, IDs, groups, snippets, link URLs packages/next/src/next-devtools/dev-overlay/components/instant/instant-guidance-data.ts Each FixCard[] array is one error family
Error headline (literal text user sees) packages/next/src/server/app-render/sync-io-messages.ts, blocking-route-messages.ts, etc. createSyncIOError, createDynamicBodyError, etc. — the template string is the headline
Existing page (content to preserve) errors/<slug>.mdx in this repo Read the full file; relocate useful content that doesn't fit fix cards into Gotchas or Other options
Canonical API docs (terminology) docs/01-app/ in this repo Cross-check every API name, directive name, and concept against the published docs
Template structure This skill file (below) The canonical shape of the page
Vercel writing style The vercel-technical-writing skill in vercel/front (not present here) Apply end-to-end; see "Voice and style" below for the rules condensed

Read the full file on GitHub · 251 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 251 lines · 83 tokens per session scan A 106619cf59b1

Subscribe to this mod's changes

insight-error-page is a skill published in the GitHub repository vercel/next.js (143,076 stars, last pushed today), licensed MIT. It adds 83 tokens to every session and 4,994 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

threejs

Build and debug 3D browser apps and games with Three.js or React Three Fiber: scene, materials, lighting, GLTF, physics, character controllers, cameras, post-processing, performance.

kyh/vibedgames · 42 tokens

Playwright (Automation + MCP + Scraper)

Browser automation via Playwright MCP. Navigate websites, click elements, fill forms, take screenshots, extract data, and debug real browser workflows. Use when (1) you need a real browser, not static fetch; (2) the task involves Playwright MCP, browser tools, Playwright tests, scripts, or JS-rendered pages; (3) the…

djblack1209-coder/OpenClaw-Bot · 104 tokens

migrate-radix-to-base

Migrates React projects and components from Radix UI to Base UI. Use when asked to migrate from radix, move to base-ui, convert radix primitives, or switch a shadcn project's base library. Handles single components ("migrate accordion") and whole projects.

shadcn-ui/ui · 61 tokens

a11y-debugging

Uses Chrome DevTools MCP for accessibility (a11y) debugging and auditing based on web.dev guidelines. Use when testing semantic HTML, ARIA labels, focus states, keyboard navigation, tap targets, and color contrast.

ChromeDevTools/chrome-devtools-mcp · 50 tokens

chrome-devtools

Uses Chrome DevTools via MCP for efficient debugging, troubleshooting and browser automation. Use when debugging web pages, automating browser interactions, analyzing performance, or inspecting network requests. This skill does not apply to --slim mode (MCP configuration).

ChromeDevTools/chrome-devtools-mcp · 55 tokens

chrome-performance-optimizer

Autonomous multi-agent performance optimization loop for Chromium and V8. Supports profile-seeded mode (analyzing Speedometer 3 / JetStream profiles via pprof or Sagacity MCP) and pattern-driven discovery mode (fan-out exploration of Blink and V8 macro-patterns grounded in historical wins and past rejected CLs).…

chromium/chromium · 119 tokens