Index of every page on this site: llms.txt
All skills
Run it yourself

Next.js 16 App Router caching and routing.

Use this Skill: https://skilld.dev/gh/pymodel/react-frontend-skills/nextjs

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈13 tokens for metadata: the name and description. ≈1.4k when used: this file. ≈22k more on demand in 44 files.

How this Skill uses context

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈51 characters, or 0.6%.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Next.js Community Next.js 16 App Router Best Practices

Comprehensive performance optimization guide for Next.js 16 App Router applications, maintained by the Next.js Community. Contains 44 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation. Current: Next.js 16.4 (16.4.5), where Cache Components with Partial Prefetching is the recommended model and create-next-app enables it by default. Three rules cover it (Instant Navigations, Partial Prefetching, ensureStatic), gated behind cacheComponents and partialPrefetching.

When to Apply

Reference these guidelines when:

  • Writing new Next.js 16 App Router code
  • Configuring caching strategies with 'use cache' directive
  • Implementing server components and data fetching
  • Setting up routing with parallel and intercepting routes
  • Creating server actions for form handling and mutations

Rule Categories by Priority

Priority Category Impact Prefix
1 Build & Bundle Optimization CRITICAL build-
2 Caching Strategy CRITICAL cache-
3 Server Components & Data Fetching HIGH server-
4 Routing & Navigation HIGH route-
5 Server Actions & Mutations MEDIUM-HIGH action-
6 Streaming & Loading States MEDIUM stream-
7 Metadata & SEO MEDIUM meta-
8 Client Components LOW-MEDIUM client-

Quick Reference

1. Build & Bundle Optimization (CRITICAL)

  • build-optimize-package-imports - Configure optimizePackageImports for large libraries
  • build-dynamic-imports - Use Dynamic Imports for Heavy Components
  • build-barrel-files - Avoid Barrel File Imports in App Router
  • build-turbopack-config - Configure Turbopack at the top level
  • build-external-packages - Configure Server External Packages for Node Dependencies

2. Caching Strategy (CRITICAL)

  • cache-use-cache-directive - Use 'use cache' with Cache Components
  • cache-revalidate-tag - Use revalidateTag with cacheLife Profiles
  • cache-fetch-options - Configure Fetch Cache Options Explicitly
  • cache-revalidate-path - Use revalidatePath for Route-Level Cache Invalidation
  • cache-react-cache - Use React cache() for Request Deduplication
  • cache-segment-config - Match route configuration to the active cache model

3. Server Components & Data Fetching (HIGH)

  • server-async-params - Await params and searchParams
  • server-parallel-fetching - Fetch Data in Parallel in Server Components
  • server-component-streaming - Stream Server Components for Progressive Loading
  • server-data-colocation - Colocate Data Fetching with Components
  • server-preload-pattern - Use Preload Pattern for Critical Data
  • server-avoid-client-fetching - Avoid Client-Side Data Fetching for Initial Data
  • server-error-handling - Handle Server Component Errors Gracefully

4. Routing & Navigation (HIGH)

  • route-parallel-routes - Use Parallel Routes for Independent Content
  • route-intercepting-routes - Use Intercepting Routes for Modal Patterns
  • route-prefetching - Configure Link Prefetching Appropriately
  • route-instant-navigations - Make Navigations Instant with Stream, Cache, or Block (16.3+)
  • route-partial-prefetching - Use Partial Prefetching for Reusable Route Shells, plus navigation() / prefetch() (16.4)
  • route-ensure-static - Guard Static Routes with ensureStatic (16.4)
  • route-proxy-ts - Use proxy.ts for network boundary logic
  • route-not-found - Use notFound() for Missing Resources

5. Server Actions & Mutations (MEDIUM-HIGH)

  • action-server-action-forms - Use Server Actions for Form Submissions
  • action-pending-states - Show Pending States with useFormStatus
  • action-error-handling - Handle Server Action Errors Gracefully
  • action-optimistic-updates - Use Optimistic Updates for Instant Feedback
  • action-revalidation - Revalidate Cache After Mutations

6. Streaming & Loading States (MEDIUM)

  • stream-suspense-boundaries - Place Suspense Boundaries Strategically
  • stream-loading-tsx - Use loading.tsx for Route-Level Loading States
  • stream-error-tsx - Use error.tsx for Route-Level Error Boundaries
  • stream-skeleton-matching - Match Skeleton Dimensions to Actual Content
  • stream-nested-suspense - Nest Suspense for Progressive Disclosure

7. Metadata & SEO (MEDIUM)

  • meta-generate-metadata - Use generateMetadata for Dynamic Metadata
  • meta-sitemap - Generate Sitemaps Dynamically
  • meta-robots - Configure Robots for Crawl Control
  • meta-opengraph-images - Generate Dynamic OpenGraph Images

8. Client Components (LOW-MEDIUM)

  • client-use-client-boundary - Minimize 'use client' Boundary Scope
  • client-children-pattern - Pass Server Components as Children to Client Components
  • client-hydration-mismatch - Avoid Hydration Mismatches
  • client-third-party-scripts - Load Third-Party Scripts Efficiently

How to Use

Run in the project root first:

npx -y @pymodel/react-frontend-skills detect  # installed vs. targeted versions

Read references/<rule-id>.md for each rule above that matches the task: why it matters, then incorrect vs. correct code.

Related Skills

  • For React 19 fundamentals, see react skill
  • For data fetching patterns, see tanstack-query skill
  • For client-side forms, see react-hook-form skill

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 alert10d3 checks · Risk SAFE
  • Gen Agent Trust Hub10d

    The skill provides a set of best practices and coding standards for Next.js App Router development. It includes a utility command for environment detection provided by the skill author.

  • Socket10d

    No alerts

  • Snyk10d

    Risk: CRITICAL · 1 issue

Signed by skilld at 85f6b47. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 2 weeks ago

README badge

README badge for pymodel/react-frontend-skills/nextjs