Agent skill · writing content · vercel
insight-error-page
Write or audit an insight-kind error page for the Next.js dev overlay. Use when creating a new `errors/<slug>.mdx` page, auditing an existing one, or checking that a page matches the framework fix cards. Covers page structure, title alignment, FixCard cards with Copy prompt button, code snippets, terminology verification against canonical docs, and Vercel technical writing style.
Why this skill is useful
Provides specific guidelines and terminology for writing and auditing Next.js error pages that the AI wouldn't reliably generate on its own.
What it needs
About 12k tokens when loaded. Last updated 2026-08-07. 141,663 stars on the source repository.
What this skill does
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 Before you start 1. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills vercel/insight-error-page