Agent-Skills.md

Agent Skills: Server & Client Components

Build async React Server Components and place 'use client' boundaries at leaf nodes for interactivity in Next.js App Router. Use when deciding RSC vs Client Component, composing server data into client wrappers, or fixing hydration errors. (triggers: app/**/*.tsx, src/app/**/*.tsx, app/**/*.jsx, src/app/**/*.jsx, use client, Server Component, Client Component, hydration)

UncategorizedID: hoangnguyen0403/agent-skills-standard/nextjs-server-components

Repository

hoangnguyen0403/agent-skills-standard
HoangNguyen0403License: Apache-2.0
362103

Install this agent skill to your local

pnpm dlx add-skill https://github.com/HoangNguyen0403/agent-skills-standard/tree/HEAD/skills/nextjs/nextjs-server-components

Skill Files

Browse the full folder contents for nextjs-server-components.

Download Skill

Loading file tree…

skills/nextjs/nextjs-server-components/SKILL.md

Skill Metadata

Name
nextjs-server-components
Description
"Build async React Server Components and place 'use client' boundaries at leaf nodes for interactivity in Next.js App Router. Use when deciding RSC vs Client Component, composing server data into client wrappers, or fixing hydration errors."

Server & Client Components

Priority: P0 (CRITICAL)

[!WARNING] If project uses pages/ directory instead of App Router, ignore this skill entirely.

App Router uses React Server Components (RSC) by default.

Workflow: Add Server/Client Component Split

  1. Default to RSC — Async Server Components for data fetching.
  2. Push 'use client' to leaves — Interactive leaf nodes only (Button, Form, Chart). Keep layouts/pages as Server Components to maximise RSC benefits.
  3. Compose via children — Pass Server Components as children to Client Components.
  4. Serialize props — Server-to-Client props must be serializable (no functions, Dates, or Classes).
  5. Guard secrets — Import server-only in modules with sensitive logic.

Composition Pattern Example

See implementation examples

Implementation Guidelines

  • Async RSCs: Fetch directly in async Server Components — await db. queries, await params for route segments.
  • Data Fetching: fetch with cache: 'no-store' or revalidate: 0 opts out of static rendering.
  • Streaming: Wrap slow async components in <Suspense>. Use loading.tsx for route-level skeletons.
  • Hydration: Server sends HTML + RSC payload; client hydrates only Client Components. Server Components: zero JS in client bundle.
  • Server-in-Client: Cannot import Server Component into Client Component.
  • Fix: Pass as children prop. See Composition Example.

Anti-Patterns

  • No secrets in Client Components: Use server-only package to prevent accidental bundling.
  • No full DB objects passed to client: Minimize serialized props; pass IDs when possible.
  • No useState/useEffect in Server Components: These Client Component-only hooks.
  • No 'use client' at tree root: Push boundary to leaf components.

References