format-storybook — скилл для Claude Code: структура Storybook
Скилл format-storybook раскладывает файлы Storybook по одному шаблону: истории рядом с компонентами, общий template, args и контролы, документация в MDX.
MIT 213 установок ★ 35 обновлён 2026-10-21
npx skills add podo/design-agent-skills --skill format-storybook -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/format-storybook/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/format-storybook/
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill format-storybook -a codex2Вручную: положить файлы
.agents/skills/format-storybook/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill format-storybook -a cursor2Вручную: положить файлы
.cursor/skills/format-storybook/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/format-storybook2Вручную: положить файлы
.github/skills/format-storybook/SKILL.md1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill format-storybook -a gemini-cli2Командой платформы
gemini skills install https://github.com/podo/design-agent-skills --path skills/format-storybookВручную: положить файлы
.devin/skills/format-storybook/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill format-storybook -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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