# format-storybook

Скилл format-storybook раскладывает файлы Storybook по одному шаблону: истории рядом с компонентами, общий template, args и контролы, документация в MDX.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 213 установок · ★ 35 у репозитория
- Автор: podo
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/podo/design-agent-skills/tree/HEAD/skills/format-storybook/SKILL.md
- Обновлён: 2026-10-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/format-storybook

## Что делает

Скилл задаёт одно правило для всей библиотеки компонентов: история лежит рядом с компонентом, в `stories/component.stories.js`, общая разметка вынесена в `stories/template.js`, а документация — в необязательный `component.docs.mdx`. Дочерние шаблоны импортируются, а не копируются, поэтому правка в одном месте не расходится по всем историям.

Аргументы и контролы строятся по принципу постепенного раскрытия: рабочие значения по умолчанию плюс контролы для краевых случаев. Скилл также разбирает CSF 3.0: метаданные в default export, истории именованными экспортами, страницы MDX с таблицами API компонента.

Для визуальной регрессии он описывает связку с Chromatic и стратегию снимков. Истории для React Native — не его случай, там нужен `storybook-rn-skill`. Готовые компоненты с нуля он тоже не пишет: это к `shadcn-ui` или `baseline-ui`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill format-storybook -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill format-storybook -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill format-storybook -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install podo/design-agent-skills skills/format-storybook
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill format-storybook -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/podo/design-agent-skills --path skills/format-storybook
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill format-storybook -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/podo/design-agent-skills/tree/HEAD/skills/format-storybook/SKILL.md

## Когда брать
- разложить истории компонентов по единой файловой схеме
- вынести повторяющуюся разметку в общий шаблон
- перевести истории на CSF 3.0
- настроить снимки Chromatic для визуальной регрессии
- собрать MDX-страницу с таблицей API компонента

## Примеры запросов агенту
- Разложи истории для `Button` по схеме: `stories/Button.stories.js`, `stories/template.js` и `Button.docs.mdx`.
- Переведи наши истории на CSF 3.0 и убери дубли разметки в общий template.
- Настрой снимки Chromatic для компонентов, которые я поменял.

## Похожие
- [writing-react-native-storybook-stories](https://affpapa.org/nevibecode/skills/writing-react-native-storybook-stories.md) — скилл · 722 установки
- [upgrading-react-native-storybook](https://affpapa.org/nevibecode/skills/upgrading-react-native-storybook.md) — скилл · 334 установки
- [storybook-stories](https://affpapa.org/nevibecode/skills/storybook-stories.md) — скилл · 317 установок
- [storybook-testing](https://affpapa.org/nevibecode/skills/storybook-testing.md) — скилл · 224 установки
- [svelte-storybook-story](https://affpapa.org/nevibecode/commands/svelte-storybook-story.md) — команда · 116 установок
- [Storybook taste](https://affpapa.org/nevibecode/prompts/storybook-taste.md) — промпт · ★ 178201 у репозитория

Из того же набора: [podo/design-agent-skills](https://affpapa.org/nevibecode/by/podo/design-agent-skills.md) — 108 карточек

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

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