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

format-storybook — скилл для Claude Code: структура Storybook

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

MIT 213 установок ★ 35 обновлён 2026-10-21

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

Что делает 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.

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

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

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

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

Как установить format-storybook

1Через Skills CLI (Vercel)

npx skills add podo/design-agent-skills --skill format-storybook -a claude-code

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

~/.claude/skills/format-storybook/SKILL.md

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

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

Вопросы о format-storybook

Как установить format-storybook в Claude Code?

Выполните npx skills add podo/design-agent-skills --skill format-storybook -a claude-code. Файл скилла появится в ~/.claude/skills/format-storybook/SKILL.md.

Что делает format-storybook?

Приводит файлы Storybook к одной схеме: истории рядом с компонентами, общий template вместо копий разметки, args и контролы, страницы документации в MDX, снимки Chromatic.

Подойдёт ли скилл для историй React Native?

Нет, для них он отправляет к storybook-rn-skill. format-storybook работает с историями веб-компонентов.

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

SKILL.md · MIT
---
name: format-storybook
description: |
  Structures and organizes Storybook files for scalability using battle-tested
  patterns from Cassondra Roberts' "A Storybook format that scales with you".
  Covers story definitions, template composition, controls/args, visual regression
  with Chromatic, component documentation, and CSF conventions. Activates on any
  Storybook question — file structure, controls, args, or component documentation.
triggers:
  - "Storybook"
  - "Storybook story"
  - "format-storybook"
  - "Chromatic visual regression"
  - "CSF story format"
  - "component story"
das:
  type: skill
  category: design-engineering
  upstream: "https://github.com/mikemai2awesome/agent-skills"
  upstream_path: "skills/format-storybook/SKILL.md"
  version: latest
---

# format-storybook

> Catalogue stub — full skill: [mikemai2awesome/agent-skills](https://github.com/mikemai2awesome/agent-skills)

<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->
## Decision tree

1. **Is the full skill already installed?**
   - Global: `f=~/.agents/skills/format-storybook/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - Project: `f=.agents/skills/format-storybook/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - `installed` → the skill is installed as `format-storybook`, invoke it and proceed
   - `pointer` → go to step 2

2. **Detect scope, then install:**

   ```bash
   [ -e ~/.agents/skills/format-storybook ] && echo "global" || echo "project"
   ```

   **Global:**
   ```bash
   npx skills add mikemai2awesome/agent-skills --skill format-storybook -g -y
   ```

   **Project:**
   ```bash
   npx skills add mikemai2awesome/agent-skills --skill format-storybook -y
   ```
   > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation.

**Heads-up**

- **License:** MIT
<!-- das:install:end -->

## Invoke after install

- Skill name: `format-storybook`
- Trigger phrases: "Storybook", "Storybook story", "Chromatic visual regression", "CSF story format"

## What it does

Enforces scalable, maintainable Storybook patterns across a component library:

- **File structure** — co-locate stories with components; `stories/component.stories.js` + `stories/template.js` + optional `component.docs.mdx`
- **Template composition** — import child component templates instead of duplicating markup; single source of truth per component
- **Controls & args** — progressive disclosure: sensible defaults + optional controls for edge cases; arg types and descriptions
- **Visual regression** — Chromatic integration patterns; snapshot testing strategy
- **CSF conventions** — Component Story Format 3.0; default export metadata; named story exports
- **Documentation** — MDX docs pages; component API tables; usage examples; do/don't patterns

## When NOT to use

- React Native Storybook stories specifically → use `storybook-rn-skill`
- Design token generation → use `design-tokens-skill`
- Component implementation from scratch → use `shadcn-ui` or `baseline-ui`

© podo · MIT · podo/design-agent-skills

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

Все скиллы по теме «Фронтенд и UI» →
writing-react-native-storybook-stories storybookjs Скилл writing-react-native-storybook-stories помогает агенту писать и править истории React Native по формату CSF: args, argTypes, декораторы, параметры аддонов и портируемые истории для тестов. CX Codex +1 722установок upgrading-react-native-storybook storybookjs Скилл upgrading-react-native-storybook пошагово обновляет Storybook в проектах на React Native с 5.3.x до 10.x. Выполняет один шаг миграции за запуск. CX Codex +1 334установок storybook-stories Pedro Nauck Скилл storybook-stories пишет и правит Storybook-сторис, опираясь на конвенции вашего репозитория. Полезен, когда сторис много, а правила именования и декораторов нигде толком не записаны. CX Codex +1 317установок storybook-testing OrchestKit Скилл storybook-testing для Claude Code помогает настраивать тестирование компонентов в Storybook 10. Он подключается при написании историй, настройке визуальных проверок и переносе проекта со Storybook 9. CX Codex +1 224установок svelte-storybook-story davila7 Команда svelte-storybook-story генерирует истории Storybook для компонентов Svelte в формате Svelte CSF с тестами взаимодействия. Пригодится при оформлении UI-кита или дизайн-системы. CX Codex +1 116установок Storybook taste f Промпт Storybook taste для ChatGPT задаёт правила оформления историй компонентов в Storybook. Он описывает структуру файлов, состояния компонентов, проверки взаимодействий и публикацию историй для ревью. GP ChatGPT ★ 178 201звёзд репо

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

Весь набор →
humanize-text Скилл humanize-text ставит тексту оценки по семи шкалам от 1 до 10 и выдаёт переписанный вариант: убирает раздутые фразы, канцелярит и лишние тире. CX Codex +1 214установок p5js-hermes Скилл p5js-hermes для генеративного и интерактивного арта на p5.js: шум, частицы, flow fields, шейдеры и выгрузка скетча в PNG, GIF или MP4. CX Codex +1 214установок open-design Скилл open-design для Claude Code — локальный daemon с web UI и MCP-сервером для генерации прототипов, лендингов, дашбордов и других дизайн-материалов через coding-agent. CX Codex +1 214установок product-position Скилл product-position для Claude Code помогает выстроить позиционирование B2B SaaS-продукта, иерархию сообщений и сравнение с альтернативами. Решает задачи позиционирования с нуля и аудита формулировок. CX Codex +1 213установок vercel-skills Ставит пять официальных скиллов Vercel: ревью интерфейса по Web Interface Guidelines, проверку текстов, производительность React/Next.js, композицию компонентов и View Transitions. CX Codex +1 213установок css-animation-skill Скилл css-animation-skill для Claude Code изучает оформление приложения в браузере и создаёт анимацию его функций на HTML и CSS для демонстраций, пошаговых показов и онбординга. CX Codex +1 213установок generative-media-skills Скилл generative-media-skills для Claude Code превращает творческий бриф в запросы к muapi.ai для постановочного видео, рекламы товаров, логотипов, мокапов интерфейса и обложек для соцсетей. CX Codex +1 212установок design-sprint Скилл design-sprint изучает кодовую базу, оформляет план фичи и предлагает разбить её на родительскую задачу и подзадачи. Создание задач в GitHub или Backlog начинается только после вашего одобрения. CX Codex +1 212установок

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

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