skills/nextjs/nextjs-optimization/SKILL.md
Optimize images, fonts, scripts, and metadata for Next.js performance and Core Web Vitals. Use when configuring next/image for LCP, next/font for zero layout shift, next/script loading strategies, or generateMetadata for SEO.
npx skillsauth add hoangnguyen0403/agent-skills-standard nextjs-optimizationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Core optimization primitives provided by Next.js. Monitor First, Optimize Later.
next/speed-insights, React Profiler.Always use next/image to prevent CLS and enable automatic optimization:
See implementation examples
Use next/font for zero layout shift — self-hosts fonts and adds font-display: swap:
See implementation examples
See implementation examples
Use next/script with appropriate loading strategies:
beforeInteractive: Critical scripts (polyfills).afterInteractive: Analytics (Google Analytics).lazyOnload: Chat widgets, social embeds.@next/bundle-analyzer. Prune heavy libraries; use ESM-tree-shakable dependencies.dynamic imports with Suspense for large components not needed at initial render.ppr: true (Partial Prerendering) in Next.js 15+ for static shell + dynamic islands.<img> tag: Use next/image to prevent CLS and enable automatic optimization.next/font to self-host and eliminate layout shift._document.tsx: Use export const metadata or generateMetadata().<head>: Use next/script with appropriate strategy.testing
Infer the requesting operator's technical fluency from message content (never ask directly) and adapt register — business, hybrid, or technical — across SDLC workflow output. Use when starting sdlc, brainstorm-feature, plan-feature, verify-work, publish-notes, or session-report, or whenever a request's phrasing signals a non-technical or cross-stack operator.
documentation
Define transaction boundaries, locking, and consistency guarantees for multi-step writes. Use when designing atomic operations, retries, idempotency, or concurrent write behavior.
development
Design relational or document schemas from access patterns, cardinality, and lifecycle. Use when modeling entities, choosing embed vs normalize, or shaping schema boundaries before implementation.
data-ai
Diagnose database latency with explain plans, index ownership, and query-shape review. Use when a query is slow, an index is missing, or scans and N+1 patterns appear.