# docs-sandpack

Скилл docs-sandpack для Claude Code задаёт правила интерактивных примеров в документации React: MDX-разметка, имена файлов, подсветка строк и стиль кода.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 11851 у репозитория
- Автор: reactjs
- Лицензия: CC-BY-4.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/reactjs/react.dev/tree/HEAD/.claude/skills/docs-sandpack/SKILL.md
- Обновлён: 2026-10-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/docs-sandpack

## Что делает

Скилл задаёт правила для интерактивных примеров в документации React. Базовый пример — блок кода в MDX внутри тега `<Sandpack>`, и у главного файла обязателен `export default`. Дополнительные файлы получают путь в info-строке: `src/Gallery.js`, метку `active` для вкладки, которая открывается первой, или `hidden` для служебных файлов. Стили кладут в блок `css`, зависимости — в `package.json`.

Дальше идут подсветка строк `{2-4}`, нумерованные выноски вида `[[1, 4, "age"]]` и `expectedErrors` для примеров, которые должны ломаться намеренно. Номера в подсветке — это номера строк: поправили код и не пересчитали их, страница упадёт при рендере. Есть раздел про стиль: объявления функций вместо стрелок, `e` для параметра события, одинарные кавычки, скобки в многострочных `if`, никакого `ReactDOM.render`.

Отдельно перечислены антипаттерны. `useState` для значения, которое не выводится на экран, даёт лишние перерисовки, чтение `window` во время рендера приводит к расхождению гидратации, а в списках нужен `key`. Имена компонентов пишут в PascalCase, обработчики — `handleClick`, действия редьюсера — в прошедшем времени.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reactjs/react.dev --skill docs-sandpack -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/docs-sandpack/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/docs-sandpack/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reactjs/react.dev --skill docs-sandpack -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/docs-sandpack/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reactjs/react.dev --skill docs-sandpack -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/docs-sandpack/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reactjs/react.dev .claude/skills/docs-sandpack
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/docs-sandpack/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reactjs/react.dev --skill docs-sandpack -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/reactjs/react.dev --path .claude/skills/docs-sandpack
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/docs-sandpack/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add reactjs/react.dev --skill docs-sandpack -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/reactjs/react.dev/tree/HEAD/.claude/skills/docs-sandpack/SKILL.md

## Когда брать
- собрать многофайловый пример Sandpack с отдельным CSS
- подключить внешнюю зависимость через `package.json` в демо
- пометить ожидаемую ошибку компилятора в намеренно сломанном примере
- пересчитать номера строк в подсветке после правки кода
- привести новый пример к стилю кода документации React

## Примеры запросов агенту
- Добавь в `Learn.md` интерактивный пример счётчика в `<Sandpack>`, главный файл с `export default`.
- Разбей пример на `src/App.js` и `src/Gallery.js`, `Gallery.js` открой как активный файл.
- Я поправил код в примере — пересчитай диапазон подсветки `{2-4}`.

## Похожие
- [rspress-docs-generator](https://affpapa.org/nevibecode/skills/rspress-docs-generator.md) — скилл · 344 установки
- [docs-write](https://affpapa.org/nevibecode/skills/docs-write.md) — скилл · 2100 установок
- [write-docs](https://affpapa.org/nevibecode/skills/tldraw-write-docs.md) — скилл · 491 установка
- [prowler-docs](https://affpapa.org/nevibecode/skills/prowler-docs.md) — скилл · ★ 15302 у репозитория
- [remotion-docs](https://affpapa.org/nevibecode/skills/remotion-dev-remotion-docs.md) — скилл · 358600 установок
- [dart-use-doc-examples](https://affpapa.org/nevibecode/skills/dart-use-doc-examples.md) — скилл · 9200 установок

Из того же набора: [reactjs/react.dev](https://affpapa.org/nevibecode/by/reactjs/react.dev.md) — 5 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
