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

storybook-stories · oakoss — скилл для Claude Code: возможности и установка

Скилл storybook-stories создаёт истории Storybook и тесты взаимодействия в формате CSF3. Помогает изолированно разрабатывать интерфейсы, настраивать снимки Chromatic и тестировать доступность.

MIT 124 установок ★ 29 обновлён 2026-08-17

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

Что делает storybook-stories

Скилл генерирует истории компонентов в синтаксисе CSF3. Для простых элементов используется объект args, а для составных вёрсток применяется функция render. Тесты взаимодействия строятся внутри метода play через утилиты userEvent и селекторы Testing Library с приоритетом на поиск по роли. Предусмотрено управление снимками регрессионного тестирования Chromatic через задержки и исключение отдельных историй.

Инструмент сфокусирован исключительно на изоляции интерфейсов и не заменяет сквозное тестирование в Playwright или проверку API. Если компонент рендерится через портал или содержит долгие анимации, поиск через canvas сломается, поэтому потребуется обращаться к body документа и оборачивать проверки в waitFor.

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

  • создать истории компонентов в формате CSF3 с типизацией args
  • написать тесты взаимодействия через функции play и вызовы userEvent
  • сконфигурировать задержки и отключение снимков для Chromatic
  • проверить корректность доступных имён кнопок и полей ввода

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

  • Сгенерируй историю CSF3 для компонента Button с play-тестом клика через userEvent
  • Настрой параметры Chromatic для компонента Modal с отключением снимков
  • Исправь селектор в истории, заменив getByTestId на поиск getByRole

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

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill storybook-stories -a claude-code

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

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

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

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

Вопросы о storybook-stories

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

Выполните команду npx skills add oakoss/agent-skills --skill storybook-stories -a claude-code. Файл скилла будет сохранён в ~/.claude/skills/storybook-stories/SKILL.md.

Что делает скилл storybook-stories?

Он формирует истории Storybook в формате CSF3, создаёт тесты пользовательского взаимодействия с play-функциями и настраивает конфигурацию для Chromatic.

Заменяет ли этот скилл сквозные тесты вроде Playwright?

Нет, скилл предназначен для изолированной разработки UI-компонентов. Для сквозных сценариев всего приложения или проверки API необходимо использовать специализированные инструменты.

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

SKILL.md · MIT
---
name: storybook-stories
description: 'Writes and maintains Storybook stories and interaction tests using CSF3 format. Covers component stories, play functions, visual regression testing with Chromatic, and accessibility testing. Use when creating component documentation, writing interaction tests, debugging test failures, configuring visual snapshots, or updating story structure. Use for CSF3, play functions, userEvent, Testing Library queries, Chromatic configuration, autodocs, MDX.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: https://storybook.js.org/docs
user-invocable: false
---

# Storybook Stories

## Overview

Storybook is a frontend workshop for building UI components in isolation. Stories are written in Component Story Format 3 (CSF3), which uses object syntax with `args` for type-safe component documentation and testing.

**When to use:** Component documentation with live examples, interaction testing with play functions, visual regression testing, accessibility validation, design system maintenance, isolated component development.

**When NOT to use:** End-to-end testing (use Playwright/Cypress), API integration testing (use Vitest/Jest), full application testing (use browser automation), performance testing (use Lighthouse/WebPageTest).

## Quick Reference

| Pattern                | API                                                    | Key Points                             |
| ---------------------- | ------------------------------------------------------ | -------------------------------------- |
| Basic story            | `export const Default: Story = { args }`               | Use args for simple single components  |
| Complex story          | `export const Example: Story = { render }`             | Use render for multi-component layouts |
| Meta configuration     | `const meta = { component, args } satisfies Meta`      | Define defaults and argTypes           |
| Interaction test       | `play: async ({ canvas, userEvent, args })`            | canvas and userEvent provided directly |
| User interaction       | `await userEvent.click(element)`                       | Always await userEvent methods         |
| Query elements         | `canvas.getByRole('button')`                           | Prefer getByRole over other queries    |
| Assertions             | `await expect(args.onPress).toHaveBeenCalled()`        | Use storybook/test assertions          |
| beforeEach hook        | `beforeEach: async ({ args }) => {}`                   | Setup mocks before story renders       |
| Play composition       | `await OtherStory.play?.(context)`                     | Reuse setup across stories             |
| Autodocs               | `tags: ['autodocs']`                                   | Enable automatic documentation         |
| Controls customization | `argTypes: { variant: { control: 'select' } }`         | Configure control panel                |
| Decorators             | `decorators: [withTheme]`                              | Add wrappers or context providers      |
| Parameters             | `parameters: { layout: 'centered' }`                   | Configure addon behavior per story     |
| Chromatic snapshot     | `parameters: { chromatic: { delay: 300 } }`            | Control visual regression captures     |
| Disable snapshot       | `parameters: { chromatic: { disableSnapshot: true } }` | Skip story in visual tests             |
| A11y testing           | `await expect(button).toHaveAccessibleName()`          | Validate accessible labels             |

## Common Mistakes

| Mistake                                    | Correct Pattern                                          |
| ------------------------------------------ | -------------------------------------------------------- |
| Using args with multi-component layouts    | Use render for complex compositions                      |
| Not awaiting userEvent methods             | Always await: `await userEvent.click(button)`            |
| Using within(canvasElement) manually       | Destructure `canvas` from play context directly          |
| Using getByTestId first                    | Prefer getByRole, getByLabelText, getByText              |
| Missing default args at meta level         | Add args to meta to prevent placeholder controls         |
| Exposing non-serializable props            | Disable className, ref, style in argTypes                |
| Not composing play functions               | Reuse setup with `await BaseStory.play?.(context)`       |
| Forgetting to mock callbacks               | Use `fn()` for event handlers: `args: { onPress: fn() }` |
| Missing accessible names for icon buttons  | Add aria-label or use aria-labelledby                    |
| Not scoping queries for portal content     | Use `within(canvasElement.ownerDocument.body)`           |
| Using boolean && for conditional rendering | Use ternary in stories for consistent snapshots          |
| Not waiting for animations                 | Wrap assertions in waitFor for async state               |

## Common Fixes

| Problem                    | Solution                                        |
| -------------------------- | ----------------------------------------------- |
| Controls show placeholders | Add `args` at meta level with default values    |
| Serialization error        | Disable `className`, `ref`, `style` in argTypes |
| Portal element not found   | Search `body` instead of `canvas`               |
| Animation timing issues    | Wrap assertions in `waitFor`                    |
| Multiple buttons found     | Add `{ name: '...' }` to getByRole              |
| A11y test failing          | Add `label` prop or `aria-label`                |

## Delegation

- **Story structure review**: Use `code-reviewer` skill for CSF3 pattern validation
- **Accessibility audit**: Use `Explore` agent to discover ARIA patterns across stories
- **Visual regression analysis**: Use `Task` agent to investigate Chromatic failures

## References

- [Story writing patterns and CSF3 syntax](references/story-writing.md)
- [Interaction tests with play functions](references/interaction-tests.md)
- [Component documentation and controls](references/component-documentation.md)
- [Visual testing with Chromatic](references/visual-testing.md)

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Фронтенд и UI» →

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

storybook-stories Pedro Nauck Скилл storybook-stories пишет и правит Storybook-сторис, опираясь на конвенции вашего репозитория. Полезен, когда сторис много, а правила именования и декораторов нигде толком не записаны. CX Codex +1 317установок storybook-story-writing TheBushidoCollective Скилл storybook-story-writing для Claude Code: пишет и правит истории Storybook в формате CSF3, покрывает все состояния компонента и держит сборку без ошибок. Останавливает расползание сториз и поломку билда. CX Codex +1 680установок storybook-testing OrchestKit Скилл storybook-testing для Claude Code помогает настраивать тестирование компонентов в Storybook 10. Он подключается при написании историй, настройке визуальных проверок и переносе проекта со Storybook 9. CX Codex +1 224установок format-storybook podo Скилл format-storybook раскладывает файлы Storybook по одному шаблону: истории рядом с компонентами, общий template, args и контролы, документация в MDX. CX Codex +1 213установок writing-react-native-storybook-stories storybookjs Скилл writing-react-native-storybook-stories помогает агенту писать и править истории React Native по формату CSF: args, argTypes, декораторы, параметры аддонов и портируемые истории для тестов. CX Codex +1 722установок storybook-play-functions TheBushidoCollective Скилл storybook-play-functions учит агента писать interaction-тесты внутри историй Storybook через функции play и библиотеку @storybook/test. CX Codex +1 119установок storybook Mindrally Задаёт правила создания историй, автодокументации и тестов компонентов в Storybook. Помогает поддерживать дизайн-систему в проектах на React. CX Codex +1 970установок

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

Весь набор →
tanstack-pacer Даёт агенту карту TanStack Pacer: дебаунс, троттлинг, лимиты, очереди и React-хуки. Ограничивает частоту срабатывания обработчиков и запросов. CX Codex +1 126установок tanstack-devtools Скилл tanstack-devtools учит агента настраивать отладку кэша Query, дерева Router и полей Form в React-приложениях с библиотеками TanStack. CX Codex +1 125установок seo-optimizer Скилл seo-optimizer про SEO-архитектуру: JSON-LD, сигналы E-E-A-T, кластеры тем и аудит контента на 30 пунктов. Ставится в Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 125установок performance-optimizer Скилл performance-optimizer оптимизирует скорость и масштабируемость приложений от фронтенда до базы данных. Помогает найти узкие места в API, настроить кеширование и устранить проблему N+1 в запросах. CX Codex +1 124установок shell-integration Скилл shell-integration для Claude Code содержит шаблоны интеграции с Bash, Zsh и Fish: автодополнения, хуки и переносимые скрипты. CX Codex +1 123установок usability-tester Скилл usability-tester помогает спланировать юзабилити-тестирование, оценить сценарии по эвристикам Нильсена и приоритизировать UX-проблемы по формуле критичности. CX Codex +1 122установок react-email Скилл react-email для Claude Code собирает адаптивные HTML-письма из React-компонентов и выводит их в HTML или обычный текст. Создаёт транзакционные письма и маркетинговые шаблоны. CX Codex +1 122установок rag-implementer Скилл rag-implementer ведёт агента по шагам RAG-пайплайна: от чанкинга и эмбеддингов до гибридного поиска и замеров качества. CX Codex +1 121установок

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

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