skills/nextjs/nextjs-styling/SKILL.md
Implement zero-runtime CSS with Tailwind, CSS Modules, and the cn() utility for RSC-compatible styling in Next.js. Use when choosing a styling library, creating dynamic class utilities, or optimizing fonts with next/font.
npx skillsauth add hoangnguyen0403/agent-skills-standard nextjs-stylingInstall 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.
Prioritize Zero-Runtime CSS for Server Components.
cn utility — Combine clsx + tailwind-merge for dynamic classes.next/font for zero-CLS self-hosted fonts.width/height or fill on <Image>.See implementation examples
| Library | Verdict | Reason |
| :------------------------- | :----------------- | :------------------------------------------------- |
| Tailwind / shadcn | Preferred (P1) | Zero-runtime, RSC compatible. Best for App Router. |
| CSS Modules / SCSS | Recommended | Scoped, zero-runtime. Good for legacy projects. |
| Ant Design | Supported | Use with Client Component wrappers for RSCs. |
| MUI / Chakra (Runtime) | Avoid | Forces use client widely. Degrades performance. |
For specific library setups, see:
clsx + tailwind-merge (cn utility).next/font to prevent Cumulative Layout Shift (CLS).width/height on images.'use client'; prefer Tailwind or CSS Modules.<img> without dimensions: Always set width/height or use fill to prevent CLS.clsx+tailwind-merge (cn) for dynamic styles.<link> tag: Use next/font for zero-CLS self-hosted fonts.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.