
Next Best Practices
This is a comprehensive reference for writing Next.js code that covers everything from RSC boundaries and async API patterns to image optimization and hydration debugging. It's especially useful for catching Next.js 15+ breaking changes like async params and the middleware rename in v16. The skill includes specific gotchas like GET route handlers conflicting with page.tsx, useSearchParams causing CSR bailouts without Suspense, and when to reach for Edge runtime over Node.js. It's organized into focused sections you can scan quickly when you hit an error or need to verify you're following current conventions. Not user-invocable, so Claude will reference it automatically when you're working on Next.js projects.
- skills.sh installs
- 394
- GitHub stars
- 652
- last updated
- Aug 21, 2026
Install
$ npx -y skills add pedronauck/skills --skill next-best-practices --agent claude-codeInstalls into .claude/skills of the current project.
Files
Next.js Best Practices
Apply these rules when writing or reviewing Next.js code.
File Conventions
See file-conventions.md for:
- Project structure and special files
- Route segments (dynamic, catch-all, groups)
- Parallel and intercepting routes
- Middleware rename in v16 (middleware → proxy)
RSC Boundaries
Detect invalid React Server Component patterns.
See rsc-boundaries.md for:
- Async client component detection (invalid)
- Non-serializable props detection
- Server Action exceptions
Async Patterns
Next.js 15+ async API changes.
See async-patterns.md for:
- Async
paramsandsearchParams - Async
cookies()andheaders() - Migration codemod
Runtime Selection
See runtime-selection.md for:
- Default to Node.js runtime
- When Edge runtime is appropriate
Directives
See directives.md for:
'use client','use server'(React)'use cache'(Next.js)
Functions
Sponsors
Details
- Repository
- github.com/pedronauck/skills
- Categories
- Frontend Development, Debugging
- First seen
- Jun 3, 2026
More from pedronauck/skills
All 70- Systematic Debugging388
- Shadcn383
- Tanstack380
- Vitest376
- Zustand362
- Vercel React Best Practices360
- Brainstorming356
- A11y Testing355
- Hormozi Ad Factory353
- Humanizer346
- Evolution Api344
- To Prompt343
- Brand Storytelling342
- Drizzle Safe Migrations339
- Vercel Composition Patterns334
- Mermaid Diagrams333
- Verification Before Completion324
- Writing Clearly And Concisely316
- Lesson Learned313
- Storybook Stories312
- Copywriting308
- Find Skills307
- Requirements Clarity304
- Adversarial Review303