next-best-practices

Standardize Next.js App Router file conventions, data patterns, and optimization.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/do-zoo/match-screening-cisc --skill next-best-practices-do-zoo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-best-practices
Source: https://github.com/do-zoo/match-screening-cisc/tree/main/.claude/skills/nextjs/upstream
Command: npx skills add https://github.com/do-zoo/match-screening-cisc --skill next-best-practices-do-zoo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a consolidated playbook of Next.js App Router best practices to ensure robust, maintainable, and performant applications by standardizing file structures, data-fetching patterns, and optimization techniques.

Core Features & Use Cases

  • File conventions: guidance on project structure and special files to ensure consistent routing and layout behavior.
  • RSC boundaries & async patterns: detect and prevent invalid server/client boundaries and apply correct async data-fetching strategies.
  • Metadata & OG images: best practices for static and dynamic metadata and Open Graph image generation.
  • Route handlers, server actions, and API patterns: recommended patterns for data access, mutations, and external integrations.
  • Asset optimization & bundling: guidance on image/font optimization, bundling considerations, and debugging tricks.
  • Debug tricks & self-hosting: practical tips for debugging Next.js apps and deploying/self-hosted configurations.

Use cases include onboarding new teams, auditing large Next.js projects for anti-patterns, and enforcing a consistent, production-grade workflow across projects.

Quick Start

Apply these guidelines to standardize your Next.js project structure and coding practices.

Frequently Asked Questions about next-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What are the Next.js App Router best practices for structuring server and client components?

Next.js App Router best practices require defining strict server/client boundaries to prevent invalid RSC crossings. You should apply correct async data-fetching strategies directly within server components while isolating interactive client logic.

How do I handle dynamic metadata and Open Graph images in Next.js?

To handle dynamic metadata and Open Graph images in Next.js, use the metadata API to define static and dynamic metadata configurations. This ensures consistent social sharing previews and SEO governance across your application's routing layers.

What is the best way to structure route handlers and server actions for data mutations in Next.js?

The best way to structure route handlers and server actions in Next.js is to standardize API patterns for data access and mutations. This approach ensures secure external integrations and consistent data modifications across your application architecture.

How do I optimize images and fonts for bundling in a self-hosted Next.js app?

To optimize images and fonts for bundling in a self-hosted Next.js app, apply Next.js asset optimization guidelines for image and font delivery. You can also use specific debug tricks to analyze bundling considerations and improve deployment configurations.

Can I use these Next.js guidelines for auditing large projects and onboarding new teams?

Yes, you can use these Next.js guidelines for auditing large projects and onboarding new teams. The playbook standardizes file conventions and routing behaviors to reduce fragmentation, enforce production-grade workflows, and accelerate project delivery.