How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/pymodel/react-frontend-skills --skill nextjsBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
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 librariesbuild-dynamic-imports- Use Dynamic Imports for Heavy Componentsbuild-barrel-files- Avoid Barrel File Imports in App Routerbuild-turbopack-config- Configure Turbopack at the top levelbuild-external-packages- Configure Server External Packages for Node Dependencies
2. Caching Strategy (CRITICAL)
cache-use-cache-directive- Use 'use cache' with Cache Componentscache-revalidate-tag- Use revalidateTag with cacheLife Profilescache-fetch-options- Configure Fetch Cache Options Explicitlycache-revalidate-path- Use revalidatePath for Route-Level Cache Invalidationcache-react-cache- Use React cache() for Request Deduplicationcache-segment-config- Match route configuration to the active cache model
3. Server Components & Data Fetching (HIGH)
server-async-params- Await params and searchParamsserver-parallel-fetching- Fetch Data in Parallel in Server Componentsserver-component-streaming- Stream Server Components for Progressive Loadingserver-data-colocation- Colocate Data Fetching with Componentsserver-preload-pattern- Use Preload Pattern for Critical Dataserver-avoid-client-fetching- Avoid Client-Side Data Fetching for Initial Dataserver-error-handling- Handle Server Component Errors Gracefully
4. Routing & Navigation (HIGH)
route-parallel-routes- Use Parallel Routes for Independent Contentroute-intercepting-routes- Use Intercepting Routes for Modal Patternsroute-prefetching- Configure Link Prefetching Appropriatelyroute-instant-navigations- Make Navigations Instant with Stream, Cache, or Block (16.3+)route-partial-prefetching- Use Partial Prefetching for Reusable Route Shells, plusnavigation()/prefetch()(16.4)route-ensure-static- Guard Static Routes with ensureStatic (16.4)route-proxy-ts- Use proxy.ts for network boundary logicroute-not-found- Use notFound() for Missing Resources
5. Server Actions & Mutations (MEDIUM-HIGH)
action-server-action-forms- Use Server Actions for Form Submissionsaction-pending-states- Show Pending States with useFormStatusaction-error-handling- Handle Server Action Errors Gracefullyaction-optimistic-updates- Use Optimistic Updates for Instant Feedbackaction-revalidation- Revalidate Cache After Mutations
6. Streaming & Loading States (MEDIUM)
stream-suspense-boundaries- Place Suspense Boundaries Strategicallystream-loading-tsx- Use loading.tsx for Route-Level Loading Statesstream-error-tsx- Use error.tsx for Route-Level Error Boundariesstream-skeleton-matching- Match Skeleton Dimensions to Actual Contentstream-nested-suspense- Nest Suspense for Progressive Disclosure
7. Metadata & SEO (MEDIUM)
meta-generate-metadata- Use generateMetadata for Dynamic Metadatameta-sitemap- Generate Sitemaps Dynamicallymeta-robots- Configure Robots for Crawl Controlmeta-opengraph-images- Generate Dynamic OpenGraph Images
8. Client Components (LOW-MEDIUM)
client-use-client-boundary- Minimize 'use client' Boundary Scopeclient-children-pattern- Pass Server Components as Children to Client Componentsclient-hydration-mismatch- Avoid Hydration Mismatchesclient-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 versionsRead 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
reactskill - For data fetching patterns, see
tanstack-queryskill - For client-side forms, see
react-hook-formskill
