Nextjs

A comprehensive rulebook for Next.js 16 App Router that covers the new caching model (explicit 'use cache' instead of implicit fetch caching), proxy.ts instead of middleware, and 45 rules across 9 categories from build optimization to caching strategy to codebase hygiene. The standout feature is the structured review algorithm for whole-repo audits: it forces you to sweep category by category (not file by file) and includes a dedicated category for codebase-level problems like duplicated server fetchers, dead routes, and unnecessary 'use client' propagation that single-file rules miss. Use it when writing new App Router code, migrating from 15 to 16, or running a serious audit. The rules include "shapes to recognize" sections that teach pattern detection beyond grep-friendly cases.

skills.sh installs: 1.2K
GitHub stars: 222
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pproenca/dot-skills --skill nextjs --agent claude-code

Installs into .claude/skills of the current project.

Files

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.