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

docs-voice · reactjs — скилл для Claude Code: что делает и как установить

Скилл docs-voice задаёт правила голоса, тональности и оформления документации в стиле официального сайта React. Пригодится при написании руководств и справочников по библиотеке.

CC-BY-4.0 ★ 11 851 обновлён 2026-10-20

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

Что делает docs-voice

Скилл передаёт агенту редакционные стандарты команды React: от правил капитализации терминов (Hook, State, Suspense) до допустимой терминологии. Он делит материалы на три типа — обучающие статьи (Learn), справочные разделы (Reference) и блог — и для каждого задаёт свой уровень технической строгости.

В правилах зафиксирован запрет на слова «simple», «easy», «just» и приблизительные оценки времени. Скилл требует объяснять поведение концепции до введения термина: например, сначала описать группировку обновлений состояния, а только потом назвать это словом batching. Для примеров кода действует запрет на var и обязательное использование JSX вместо createElement.

Скилл не создаёт документацию с нуля сам по себе, а направляет формулировки и оформление примеров во всех ответах агента.

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

  • соблюсти официальный стиль документации react.dev
  • убрать снисходительную лексику вроде «просто» и «легко»
  • выровнять регистр названий сущностей вроде Hook и Server Action
  • переписать сложные термины простыми объяснениями без жаргона

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

  • Проверь черновик статьи про useTransition по правилам react.dev
  • Напиши справочный раздел для хука в техническом тоне Reference
  • Перепиши объяснение батчинга состояний без академического жаргона

Как установить docs-voice

1Через Skills CLI (Vercel)

npx skills add reactjs/react.dev --skill docs-voice -a claude-code

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

~/.claude/skills/docs-voice/SKILL.md

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

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

Вопросы о docs-voice

Как установить docs-voice в Claude Code?

Выполните в терминале команду npx skills add reactjs/react.dev --skill docs-voice -a claude-code. Файл скилла сохранится по пути ~/.claude/skills/docs-voice/SKILL.md.

Что делает docs-voice?

Он задаёт правила оформления документации React: структуру аналогий, форматирование названий инструментов и ограничение на снисходительные слова.

Как скилл рекомендует заменять технический жаргон?

Вместо абстракций вроде «memoize» или «idempotent» предписывается описывать конкретное поведение простыми словами — например, «remember the result» или «same inputs, same output».

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

SKILL.md · CC-BY-4.0
---
name: docs-voice
description: Use when writing any React documentation. Provides voice, tone, and style rules for all doc types.
---

# React Docs Voice & Style

## Universal Rules

- **Capitalize React terms** when referring to the React concept in headings or as standalone concepts:
  - Core: Hook, Effect, State, Context, Ref, Component, Fragment
  - Concurrent: Transition, Action, Suspense
  - Server: Server Component, Client Component, Server Function, Server Action
  - Patterns: Error Boundary
  - Canary: Activity, View Transition, Transition Type
  - **In prose:** Use lowercase when paired with descriptors: "state variable", "state updates", "event handler". Capitalize when the concept stands alone or in headings: "State is isolated and private"
  - General usage stays lowercase: "the page transitions", "takes an action"
- **Product names:** ESLint, TypeScript, JavaScript, Next.js (not lowercase)
- **Bold** for key concepts: **state variable**, **event handler**
- **Italics** for new terms being defined: *event handlers*
- **Inline code** for APIs: `useState`, `startTransition`, `<Suspense>`
- **Avoid:** "simple", "easy", "just", time estimates
- Frame differences as "capabilities" not "advantages/disadvantages"
- Avoid passive voice and jargon

## Tone by Page Type

| Type | Tone | Example |
|------|------|---------|
| Learn | Conversational | "Here's what that looks like...", "You might be wondering..." |
| Reference | Technical | "Call `useState` at the top level...", "This Hook returns..." |
| Blog | Accurate | Focus on facts, not marketing |

**Note:** Pitfall and DeepDive components can use slightly more conversational phrasing ("You might wonder...", "It might be tempting...") even in Reference pages, since they're explanatory asides.

## Avoiding Jargon

**Pattern:** Explain behavior first, then name it.

✅ "React waits until all code in event handlers runs before processing state updates. This is called *batching*."

❌ "React uses batching to process state updates atomically."

**Terms to avoid or explain:**
| Jargon | Plain Language |
|--------|----------------|
| atomic | all-or-nothing, batched together |
| idempotent | same inputs, same output |
| deterministic | predictable, same result every time |
| memoize | remember the result, skip recalculating |
| referentially transparent | (avoid - describe the behavior) |
| invariant | rule that must always be true |
| reify | (avoid - describe what's being created) |

**Allowed technical terms in Reference pages:**
- "stale closures" - standard JS/React term, can be used in Caveats
- "stable identity" - React term for consistent object references across renders
- "reactive" - React term for values that trigger re-renders when changed
- These don't need explanation in Reference pages (readers are expected to know them)

**Use established analogies sparingly—once when introducing a concept, not repeatedly:**

| Concept | Analogy |
|---------|---------|
| Components/React | Kitchen (components as cooks, React as waiter) |
| Render phases | Restaurant ordering (trigger/render/commit) |
| State batching | Waiter collecting full order before going to kitchen |
| State behavior | Snapshot/photograph in time |
| State storage | React storing state "on a shelf" |
| State purpose | Component's memory |
| Pure functions | Recipes (same ingredients → same dish) |
| Pure functions | Math formulas (y = 2x) |
| Props | Adjustable "knobs" |
| Children prop | "Hole" to be filled by parent |
| Keys | File names in a folder |
| Curly braces in JSX | "Window into JavaScript" |
| Declarative UI | Taxi driver (destination, not turn-by-turn) |
| Imperative UI | Turn-by-turn navigation |
| State structure | Database normalization |
| Refs | "Secret pocket" React doesn't track |
| Effects/Refs | "Escape hatch" from React |
| Context | CSS inheritance / "Teleportation" |
| Custom Hooks | Design system |

## Common Prose Patterns

**Wrong vs Right code:**
```mdx
\`\`\`js
// 🚩 Don't mutate state:
obj.x = 10;
\`\`\`

\`\`\`js
// ✅ Replace with new object:
setObj({ ...obj, x: 10 });
\`\`\`
```

**Table comparisons:**
```mdx
| passing a function | calling a function |
| `onClick={handleClick}` | `onClick={handleClick()}` |
```

**Linking:**
```mdx
[Read about state](/learn/state-a-components-memory)
[See `useState` reference](/reference/react/useState)
```

## Code Style

- Prefer JSX over createElement
- Use const/let, never var
- Prefer named function declarations for top-level functions
- Arrow functions for callbacks that need `this` preservation

## Version Documentation

When APIs change between versions:

```mdx
Starting in React 19, render `<Context>` as a provider:
\`\`\`js
<SomeContext value={value}>{children}</SomeContext>
\`\`\`

In older versions:
\`\`\`js
<SomeContext.Provider value={value}>{children}</SomeContext.Provider>
\`\`\`
```

Patterns:
- "Starting in React 19..." for new APIs
- "In older versions of React..." for legacy patterns

© reactjs · CC-BY-4.0 · reactjs/react.dev

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

Все скиллы по теме «Тексты и документация» →

Сначала — docs-voice от других авторов.

docs-voice devvmhq Скилл docs-voice для Claude Code переписывает документацию devvm ясным языком, сохраняя факты. Включается при написании и редактировании страниц, README, справки команд и сообщений CLI. CX Codex +1 ★ 738звёзд репо docs-review metabase Скилл docs-review проверяет изменения в markdown-документации на соответствие стайлгайду Metabase и выдаёт нумерованный список замечаний. CX Codex +1 2 000установок prowler-docs prowler-cloud Скилл prowler-docs для Claude Code задаёт стиль и структуру документации Prowler: голос бренда, Title Case, MDX-блоки и правила для терминов. Используется при написании гайдов и release notes. CX Codex +1 ★ 15 302звёзд репо google-dev-docs surendranb Скилл google-dev-docs для Claude Code задаёт стиль Google для техдокументации: заголовки-действия, обращение на «вы», настоящее время, активный залог. Применяется при написании README, туториалов и справок по API. CX Codex +1 ★ 57звёзд репо ane-voice gasserane Скилл ane-voice для Claude Code проверяет черновики на шаблонные обороты нейросетей и переписывает текст в строгом деловом стиле. Включается по запросу отредактировать или очистить текст от штампов. CX Codex +1 678установок brand-voice-analyzer OneWave-AI Скилл brand-voice-analyzer разбирает тексты компании, формирует гайдлайн по тону бренда и проверяет новые статьи на соответствие ему. CX Codex +1 281установок writing-guidelines vercel Скилл writing-guidelines для ревью документации и прозы по письменному гайдлайну. Возвращает замечания с номерами строк, чтобы правки не искать по всему файлу вручную. CX Codex +1 133 400установок

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

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

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