Individual skill
nextjs
Next.js 16 App Router performance, caching, server components, server actions, routing, and codebase-hygiene best practices — plus a category-major review/refactor algorithm with codebase-level (remove/dedup/reuse) findings. This skill should be used when writing Next.js 16 App Router code, configuring caching with 'use cache', building Server Components, setting up parallel/intercepting routes, configuring next.config.js OR proxy.ts, OR auditing/refactoring a Next.js codebase (single file or whole repo). This skill does NOT cover generic React 19 patterns (use react skill) or non-Next.js server rendering.
skills/.curated/nextjs/SKILL.md
Source commit cf93c57cac89d6fc3e4194686000411567f5caf3
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 222
- Repository last updated
- Aug 15, 2026
- License
- MIT
Observed agent integration: codex
- engineering Derived category
- writing Derived category
- engineering-web Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
AGENTS.mddoc · 8,017 bytesREADME.mddoc · 3,217 bytesSKILL.mdcore · 14,791 bytesSKILL.mdcore · 14,791 bytesassets/templates/_template.mddoc · 557 bytesmetadata.jsonasset · 1,499 bytesreferences/_review-algorithm.mddoc · 13,516 bytesreferences/_sections.mddoc · 2,794 bytesreferences/action-error-handling.mddoc · 3,188 bytesreferences/action-optimistic-updates.mddoc · 3,327 bytesreferences/action-pending-states.mddoc · 2,953 bytesreferences/action-revalidation.mddoc · 3,023 bytesreferences/action-server-action-forms.mddoc · 6,603 bytesreferences/build-barrel-files.mddoc · 2,640 bytesreferences/build-dynamic-imports.mddoc · 4,774 bytesreferences/build-external-packages.mddoc · 2,487 bytesreferences/build-optimize-package-imports.mddoc · 2,632 bytesreferences/build-turbopack-config.mddoc · 2,754 bytesreferences/cache-fetch-options.mddoc · 3,304 bytesreferences/cache-react-cache.mddoc · 3,115 bytesreferences/cache-revalidate-path.mddoc · 3,173 bytesreferences/cache-revalidate-tag.mddoc · 3,004 bytesreferences/cache-segment-config.mddoc · 3,269 bytesreferences/cache-use-cache-directive.mddoc · 4,940 bytesreferences/client-children-pattern.mddoc · 3,365 bytesreferences/client-hydration-mismatch.mddoc · 3,150 bytesreferences/client-third-party-scripts.mddoc · 3,435 bytesreferences/client-use-client-boundary.mddoc · 6,303 bytesreferences/cross-boundary-coherence.mddoc · 6,144 bytesreferences/cross-component-consolidation.mddoc · 5,361 bytesreferences/cross-dead-code.mddoc · 5,476 bytesreferences/cross-extract-shared-logic.mddoc · 4,977 bytesreferences/cross-prop-shape-drift.mddoc · 5,598 bytesreferences/meta-generate-metadata.mddoc · 2,991 bytesreferences/meta-opengraph-images.mddoc · 3,226 bytesreferences/meta-robots.mddoc · 2,729 bytesreferences/meta-sitemap.mddoc · 3,064 bytesreferences/route-intercepting-routes.mddoc · 3,464 bytesreferences/route-not-found.mddoc · 2,886 bytesreferences/route-parallel-routes.mddoc · 3,350 bytesreferences/route-prefetching.mddoc · 3,147 bytesreferences/route-proxy-ts.mddoc · 3,030 bytesreferences/server-avoid-client-fetching.mddoc · 5,959 bytesreferences/server-component-streaming.mddoc · 3,073 bytesreferences/server-data-colocation.mddoc · 3,103 bytesreferences/server-error-handling.mddoc · 2,955 bytesreferences/server-parallel-fetching.mddoc · 5,512 bytesreferences/server-preload-pattern.mddoc · 3,273 bytesreferences/stream-error-tsx.mddoc · 3,054 bytesreferences/stream-loading-tsx.mddoc · 2,900 bytesreferences/stream-nested-suspense.mddoc · 3,512 bytesreferences/stream-skeleton-matching.mddoc · 3,269 bytesreferences/stream-suspense-boundaries.mddoc · 2,897 bytes
Read excerpt
# Next.js 16 App Router Best Practices
Comprehensive Next.js 16 App Router guide for AI agents. Contains **45 rules across 9 categories**, prioritized by impact from critical (build optimization, caching strategy) through to cross-cutting codebase hygiene (dedup, dead routes, boundary coherence). Reflects Next.js 16 changes: `'use cache'` directive replacing implicit caching, `revalidateTag(tag, cacheLife)` requirement, `proxy.ts` replacing `middleware.ts`, Turbopack persistent caching, App Router conventions.
Rule files describe **pattern shapes** (not API names) and open with a **"Shapes to recognize"** section listing 2–4 syntactic disguises the same break can wear. **Selected high-value rules** (those whose disguises are most common in practice — `'use cache'`, parallel-fetching, dynamic-imports, server-action-forms, client-boundary, server-vs-client-fetching) include an extra concrete **"In disguise"** incorrect/correct example pair to teach pattern detection beyond the grep-friendly cases.
## When to Apply
- Writing new Next.js 16 App Router code
- **Auditing or modernizing a Next.js codebase** — single file, PR, or whole repo (see [`references/_review-algorithm.md`](references/_review-algorithm.md))
- Migrating from Next.js 15 to 16 (implicit caching → `'use cache'`, `middleware.ts` → `proxy.ts`, `revalidateTag` single-arg → with `cacheLife`)
- Configuring caching strategies with `'use cache'`, `unstable_cache`, `revalidateTag`, `revalidatePath`
- Implementing Server Components and parallel/colocated data fetching
- Setting up parallel routes, intercepting routes, prefetching, `proxy.ts`