К основному содержанию
скилл CX Codex

server-components — скилл Claude Code: установка

Скилл объясняет архитектуру React Server Components в Next.js: границы Server и Client Components, композицию и загрузку данных.

MIT 158 установок ★ 3 785 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add davepoon/buildwithclaude --skill server-components -a claude-code
Открыть на GitHub

Что делает server-components

Скилл разбирает архитектуру React Server Components в Next.js App Router. Он объясняет, почему компоненты по умолчанию выполняются на сервере, когда нужен 'use client', как передавать данные в интерактивные компоненты и как держать чувствительные данные на сервере.

Внутри есть правила границы между Server и Client Components, композиция через children и слоты, асинхронная загрузка, параллельные запросы и потоковая выдача через Suspense. Также разобраны частые ошибки и файлы с дополнительными примерами. Client Component не может импортировать Server Component, поэтому структуру импортов нужно проверять заранее.

Какие задачи решает

  • разделить компоненты по серверной и клиентской границе
  • передать данные из Server Component в интерактивный компонент
  • выбрать место для директивы 'use client'
  • собрать композицию через children и слоты
  • организовать параллельную загрузку данных

Примеры запросов агенту

  • Разбери этот экран Next.js и укажи, какие компоненты должны быть Server Components, а какие Client Components.
  • Покажи, как передать данные из страницы в интерактивный список через props.
  • Перепиши загрузку данных так, чтобы независимые запросы выполнялись параллельно и медленный блок стримился через Suspense.

Как установить server-components

1Через Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill server-components -a claude-code

2Вручную: положить файлы

~/.claude/skills/server-components/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/server-components/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о server-components

Как установить server-components в Claude Code?

Выполните npx skills add davepoon/buildwithclaude --skill server-components -a claude-code, затем проверьте файл ~/.claude/skills/server-components/SKILL.md.

Что делает server-components?

Скилл помогает проектировать React Server Components в Next.js: выбирать между серверными и клиентскими компонентами, строить композицию и загружать данные.

Может ли Client Component импортировать Server Component?

Нет. Server Components могут импортировать Client Components, а для передачи серверного содержимого в клиентскую оболочку используется children или слот.

Исходный текст

SKILL.md · MIT
---
name: server-components
description: This skill should be used when the user asks about "Server Components", "Client Components", "'use client' directive", "when to use server vs client", "RSC patterns", "component composition", "data fetching in components", or needs guidance on React Server Components architecture in Next.js.
version: 1.0.0
---

# React Server Components in Next.js

## Overview

React Server Components (RSC) allow components to render on the server, reducing client-side JavaScript and enabling direct data access. In Next.js App Router, all components are Server Components by default.

## Server vs Client Components

### Server Components (Default)

Server Components run only on the server:

```tsx
// app/users/page.tsx (Server Component - default)
async function UsersPage() {
  const users = await db.user.findMany() // Direct DB access

  return (
    <ul>
      {users.map(user => (
        <li key={user.id}>{user.name}</li>
      ))}
    </ul>
  )
}
```

**Benefits:**
- Direct database/filesystem access
- Keep sensitive data on server (API keys, tokens)
- Reduce client bundle size
- Automatic code splitting

### Client Components

Add `'use client'` directive for interactivity:

```tsx
// components/counter.tsx
'use client'

import { useState } from 'react'

export function Counter() {
  const [count, setCount] = useState(0)

  return (
    <button onClick={() => setCount(count + 1)}>
      Count: {count}
    </button>
  )
}
```

**Use Client Components for:**
- `useState`, `useEffect`, `useReducer`
- Event handlers (`onClick`, `onChange`)
- Browser APIs (`window`, `document`)
- Custom hooks with state

## The Mental Model

Think of the component tree as having a "client boundary":

```
Server Component (page.tsx)
├── Server Component (header.tsx)
├── Client Component ('use client') ← boundary
│   ├── Client Component (child)
│   └── Client Component (child)
└── Server Component (footer.tsx)
```

**Key rules:**
1. Server Components can import Client Components
2. Client Components cannot import Server Components
3. You can pass Server Components as `children` to Client Components

## Composition Patterns

### Pattern 1: Server Data → Client Interactivity

Fetch data in Server Component, pass to Client:

```tsx
// app/products/page.tsx (Server)
import { ProductList } from './product-list'

export default async function ProductsPage() {
  const products = await getProducts()
  return <ProductList products={products} />
}

// app/products/product-list.tsx (Client)
'use client'

export function ProductList({ products }: { products: Product[] }) {
  const [filter, setFilter] = useState('')

  const filtered = products.filter(p =>
    p.name.includes(filter)
  )

  return (
    <>
      <input onChange={e => setFilter(e.target.value)} />
      {filtered.map(p => <ProductCard key={p.id} product={p} />)}
    </>
  )
}
```

### Pattern 2: Children as Server Components

Pass Server Components through children prop:

```tsx
// components/client-wrapper.tsx
'use client'

export function ClientWrapper({ children }: { children: React.ReactNode }) {
  const [isOpen, setIsOpen] = useState(false)

  return (
    <div>
      <button onClick={() => setIsOpen(!isOpen)}>Toggle</button>
      {isOpen && children} {/* Server Component content */}
    </div>
  )
}

// app/page.tsx (Server)
import { ClientWrapper } from '@/components/client-wrapper'
import { ServerContent } from '@/components/server-content'

export default function Page() {
  return (
    <ClientWrapper>
      <ServerContent /> {/* Renders on server! */}
    </ClientWrapper>
  )
}
```

### Pattern 3: Slots for Complex Layouts

Use multiple children slots:

```tsx
// components/dashboard-shell.tsx
'use client'

interface Props {
  sidebar: React.ReactNode
  main: React.ReactNode
}

export function DashboardShell({ sidebar, main }: Props) {
  const [collapsed, setCollapsed] = useState(false)

  return (
    <div className="flex">
      {!collapsed && <aside>{sidebar}</aside>}
      <main>{main}</main>
    </div>
  )
}
```

## Data Fetching

### Async Server Components

Server Components can be async:

```tsx
// app/posts/page.tsx
export default async function PostsPage() {
  const posts = await fetch('https://api.example.com/posts')
    .then(res => res.json())

  return (
    <ul>
      {posts.map(post => (
        <li key={post.id}>{post.title}</li>
      ))}
    </ul>
  )
}
```

### Parallel Data Fetching

Fetch multiple resources in parallel:

```tsx
export default async function DashboardPage() {
  const [user, posts, analytics] = await Promise.all([
    getUser(),
    getPosts(),
    getAnalytics(),
  ])

  return (
    <Dashboard user={user} posts={posts} analytics={analytics} />
  )
}
```

### Streaming with Suspense

Stream slow components:

```tsx
import { Suspense } from 'react'

export default function Page() {
  return (
    <div>
      <Header /> {/* Renders immediately */}
      <Suspense fallback={<PostsSkeleton />}>
        <SlowPosts /> {/* Streams when ready */}
      </Suspense>
    </div>
  )
}
```

## Decision Guide

**Use Server Component when:**
- Fetching data
- Accessing backend resources
- Keeping sensitive info on server
- Reducing client JavaScript
- Component has no interactivity

**Use Client Component when:**
- Using state (`useState`, `useReducer`)
- Using effects (`useEffect`)
- Using event listeners
- Using browser APIs
- Using custom hooks with state

## Common Mistakes

1. **Don't** add `'use client'` unnecessarily - it increases bundle size
2. **Don't** try to import Server Components into Client Components
3. **Do** serialize data at boundaries (no functions, classes, or dates)
4. **Do** use the children pattern for composition

## Resources

For detailed patterns, see:
- `references/server-vs-client.md` - Complete comparison guide
- `references/composition-patterns.md` - Advanced composition
- `examples/data-fetching-patterns.md` - Data fetching examples

© davepoon · MIT · davepoon/buildwithclaude

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
nextjs-app-router-expert curiositech Скилл nextjs-app-router-expert помогает проектировать и отлаживать приложения на Next.js 14/15 с App Router. Пригодится при настройке маршрутов, Server Actions и загрузки данных. CX Codex +1 176установок react-server-components-framework OrchestKit Скилл react-server-components-framework задаёт серверный подход к приложениям Next.js с React Server Components, App Router, кэшированием, потоковым SSR и Server Actions. CX Codex +1 227установок react-server-components patterns.dev Скилл объясняет React Server Components: какие компоненты рендерить на сервере и где ставить 'use client'. Пригодится в Next.js App Router. CX Codex +1 1 000установок cache-components sangrokjung Скилл учит агента применять Cache Components и Partial Prerendering в Next.js: директива 'use cache', настройка времени жизни через cacheLife(), инвалидация по тегам. CX Codex +1 ★ 880звёзд репо nextjs-app-router-patterns Seth Hobson Скилл nextjs-app-router-patterns помогает строить приложения на Next.js App Router: выбирать режим рендеринга, организовывать маршруты и получать данные. Подойдёт при миграции с Pages Router или работе с Server Components. CX Codex +1 32 529установок nextjs-development manutej Скилл nextjs-development для Claude Code задаёт правила разработки на Next.js в каталоге app: серверные компоненты, кэширование и маршруты. CX Codex +1 475установок

Из того же набора235

Весь набор →
file-organizer Скилл file-organizer анализирует папки, находит дубликаты, предлагает структуру и переносит файлы по твоему одобрению. Работает через bash-команды. CX Codex +1 355установок server-actions Помогает агенту писать Server Actions в Next.js App Router: от валидации форм через Zod до хука useFormStatus и сброса кэша. CX Codex +1 204установок macos-design Скилл macos-design для Claude Code помогает проектировать интерфейсы macOS по системным паттернам, со светлой и тёмной темами. Задача — проектирование интерфейсов десктопных приложений и утилит. CX Codex +1 192установок auth-patterns Скилл auth-patterns для Claude Code собирает шаблоны аутентификации Next.js: настройку NextAuth.js v5, защиту маршрутов через middleware, RBAC и работу с сессиями в серверных компонентах. CX Codex +1 183установок app-router Скилл для создания маршрутов, лейаутов, состояний загрузки и границ ошибок в Next.js App Router. Помогает агенту правильно организовать файловую структуру проекта. CX Codex +1 153установок route-handlers Скилл route-handlers помогает ИИ-агенту писать API-роуты для Next.js App Router: от стандартных эндпоинтов до потоковой передачи данных и настройки CORS. CX Codex +1 152установок canva-automation Скилл canva-automation управляет дизайнами, ассетами, папками и автозаполнением шаблонов в Canva через Rube MCP. CX Codex +1 149установок google-calendar-automation Скилл google-calendar-automation управляет событиями Google Calendar, ищет свободные интервалы и работает с участниками через Rube MCP. CX Codex +1 142установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой