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

storybook-testing — скилл для Claude Code: тесты Storybook

Скилл storybook-testing для Claude Code помогает настраивать тестирование компонентов в Storybook 10. Он подключается при написании историй, настройке визуальных проверок и переносе проекта со Storybook 9.

MIT 224 установок ★ 305 обновлён 2026-11-21

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

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

Скилл описывает, как превращать истории Storybook в тесты компонентов. Он охватывает CSF3 с TypeScript, проверки взаимодействий через play() и запуск историй в Vitest с @storybook/addon-vitest.

Для визуальной регрессии он разбирает Chromatic TurboSnap, а для проверок доступности — @storybook/addon-a11y и запуск аудитов в CI. Также в руководстве есть модульные моки через sb.mock, autodocs и миграция со Storybook 9. Storybook 10 требует Node 20.16+, 22.19+ или 24+; целевая версия в настройках скилла — 10.6.1 и выше.

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

  • написать типизированную историю компонента в формате CSF3
  • проверить пользовательский сценарий через play()
  • запустить истории как тесты Vitest
  • настроить визуальную регрессию с TurboSnap
  • проверить доступность компонентов в CI

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

  • Настрой тестирование историй компонентов в Storybook 10 через Vitest.
  • Добавь к истории кнопки проверку клика через play().
  • Покажи, как настроить TurboSnap и проверку доступности в CI.

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

1Через Skills CLI (Vercel)

npx skills add yonatangross/orchestkit --skill storybook-testing -a claude-code

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

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

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

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

Вопросы о storybook-testing

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

Выполни npx skills add yonatangross/orchestkit --skill storybook-testing -a claude-code. Файл скилла находится по пути ~/.claude/skills/storybook-testing/SKILL.md.

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

Помогает настраивать тестирование компонентов в Storybook 10: проверки взаимодействий, визуальную регрессию, аудит доступности и документацию autodocs.

Какая версия Node нужна для Storybook 10 с этим скиллом?

Нужен Node 20.16+, 22.19+ или 24+. Руководство нацелено на Storybook 10.6.1 и выше.

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

SKILL.md · MIT
---
name: storybook-testing
license: MIT
compatibility: "Claude Code 2.1.277+."
description: "Storybook 10 testing: Vitest integration, CSF3 factories, play() interaction tests, Chromatic TurboSnap, automocking, a11y addon, autodocs. Use when writing component stories, setting up visual regression, Storybook CI, or migrating from Storybook 9."
user-invocable: false
# Reference skill: fenced Storybook MCP names teach CSF/testing patterns; this
# skill never invokes those tools (disable-model-invocation: true).
tool-coverage: illustrative
targets:
  - library: storybook
    version: ">=10.6.1"
metadata:
  archive-candidate: "pending an outside usage signal"
  owner-agent: "frontend-ui-developer"
  category: document-asset-creation
  storybook-version: "10.3"
  version: "2.0.0"
  author: "OrchestKit"
  complexity: "medium"
  tags: "storybook, vitest, csf3, chromatic, turbosnap, visual-regression, play-functions, component-testing, a11y-testing, autodocs, esm-only, module-automocking"
allowed-tools: "Read Glob Grep WebFetch WebSearch"
---

# Storybook Testing — Storybook 10

## Overview

Storybook 10 unifies component testing into a single workflow: **interaction tests** via `play()` functions, **visual regression** via Chromatic TurboSnap, and **accessibility audits** via the a11y addon — all running through Vitest. Stories are executable test specifications, not just documentation.

**What's new in Storybook 10** (vs 9):
- **ESM-only enforced** — the single breaking change; Node 20.16+ / 22.19+ / 24+ required; 29% smaller install
- **Module automocking (`sb.mock`)** — build-time module mocking, scoped per-project in preview.ts
- **CSF factories (React, preview)** — `defineMain` → `definePreview` → `preview.meta()` → `meta.story()` chain
- **Essential addons in core** — viewport, controls, interactions, actions no longer separate deps
- **Import path changes** — `@storybook/test` → `storybook/test` (old paths still work as aliases)
- **React Server Component story support** — test RSC in isolation
- **Vitest 4 support** — `experimental-addon-test` renamed to `addon-vitest`

**When to use this skill:**
- Writing component stories in CSF3 format with TypeScript
- Setting up interaction tests with `play()` functions
- Configuring Chromatic visual regression with TurboSnap
- Using module automocking at the story level
- Running accessibility tests in CI via the a11y addon
- Generating living documentation with autodocs
- Migrating from Storybook 9 to 10

---

## Quick Reference

| Rule | Impact | Description |
|------|--------|-------------|
| `storybook-csf3-factories` | HIGH | Typesafe CSF3 story factories with `satisfies Meta` |
| `storybook-play-functions` | CRITICAL | Interaction testing with `play()` and `@storybook/test` |
| `storybook-vitest-integration` | HIGH | Run stories as Vitest tests via `@storybook/addon-vitest` |
| `storybook-chromatic-turbosnap` | HIGH | TurboSnap reduces snapshot cost 60-90% |
| `storybook-sb-mock` | HIGH | Story-level module mocking with `sb.mock` |
| `storybook-a11y-testing` | CRITICAL | Automated axe-core accessibility scans in CI |
| `storybook-autodocs` | MEDIUM | Auto-generated docs from stories |

---

## Storybook Testing Pyramid

```
         ┌──────────────┐
         │   Visual     │  Chromatic TurboSnap
         │  Regression  │  (snapshot diffs)
         ├──────────────┤
         │ Accessibility│  @storybook/addon-a11y
         │   (a11y)     │  (axe-core scans)
         ├──────────────┤
         │ Interaction  │  play() functions
         │   Tests      │  (@storybook/test)
         ├──────────────┤
         │  Unit Tests  │  Vitest + storybookTest
         │  (stories)   │  plugin
         └──────────────┘
```

Each layer catches different defects: unit tests validate logic, interaction tests verify user flows, a11y tests catch accessibility violations, and visual tests catch unintended UI regressions.

---

## Quick Start

### CSF3 Story with Play Function

```tsx
// Button.stories.tsx
import type { Meta, StoryObj } from '@storybook/react'
import { expect, fn, userEvent, within } from 'storybook/test'
import { Button } from './Button'

const meta = {
  component: Button,
  args: {
    onClick: fn(),
  },
} satisfies Meta<typeof Button>

export default meta
type Story = StoryObj<typeof meta>

export const Primary: Story = {
  args: {
    label: 'Click me',
    variant: 'primary',
  },
  play: async ({ canvasElement, args }) => {
    const canvas = within(canvasElement)
    const button = canvas.getByRole('button', { name: /click me/i })

    await userEvent.click(button)
    await expect(args.onClick).toHaveBeenCalledOnce()
    await expect(button).toHaveStyle({ backgroundColor: 'rgb(37, 99, 235)' })
  },
}
```

### Vitest Configuration

```ts
// vitest.config.ts
import { storybookTest } from '@storybook/addon-vitest/vitest-plugin'
import { defineConfig } from 'vitest/config'

export default defineConfig({
  plugins: [storybookTest()],
  test: {
    setupFiles: ['./vitest.setup.ts'],
  },
})
```

---

## Key Principles

- **Stories are tests.** Every story with a `play()` function is an executable interaction test that runs in Vitest.
- **CSF3 + `satisfies` for type safety.** Use `satisfies Meta<typeof Component>` for full type inference on args and play functions.
- **Module automocking (SB 10).** Register `sb.mock(import(...))` in `.storybook/preview.ts`, configure per-story with `mocked()` in `beforeEach`. Never use `vi.mock` in story files. No factory functions — `sb.mock` is build-time, not runtime.
- **TurboSnap for CI speed.** Only snapshot stories affected by code changes — reduces Chromatic usage by 60-90%.
- **Accessibility is not optional.** The a11y addon runs axe-core scans on every story and gates CI on violations.
- **Living documentation.** Autodocs generates prop tables and usage examples directly from stories — no separate docs site needed.

---

## Anti-Patterns (FORBIDDEN)

| Anti-Pattern | Why It Fails | Use Instead |
|-------------|-------------|-------------|
| CSF2 `Template.bind({})` | Deprecated, no type inference, will be removed in SB 11 | CSF3 object stories with `satisfies` |
| `@storybook/test-runner` package | Deprecated since Storybook 9 | `@storybook/addon-vitest` |
| `vi.mock()` in story files | Leaks between stories, breaks isolation | Register `sb.mock(import(...))` in preview.ts, configure with `mocked()` in beforeEach |
| Full Chromatic snapshots on every PR | Expensive and slow | TurboSnap with `onlyChanged: true` |
| Manual accessibility checking | Misses violations, not repeatable | `@storybook/addon-a11y` in CI pipeline |
| Separate documentation site | Drifts from actual component behavior | Autodocs with `tags: ['autodocs']` |
| Testing implementation details | Brittle, breaks on refactors | Test user-visible behavior via `play()` |
| CJS imports in stories | ESM-only since SB 9/10 | Use ESM imports, set `"module": "ESNext"` in tsconfig |

---

## Storybook MCP Integration (addon-mcp)

When `@storybook/addon-mcp` is installed, agents can run tests and preview stories via MCP instead of CLI. This enables the **generate → test → self-heal** loop.

### MCP Tools for Testing

| Tool | Purpose |
|------|---------|
| `run-story-tests` | Run component + a11y tests via MCP, returns pass/fail + violation details |
| `preview-stories` | Returns preview URLs for visual verification in chat |
| `get-storybook-story-instructions` | Guidance on writing effective stories + interaction tests |

### Agent Testing Loop

```python
# 1. Generate component + CSF3 story
# 2. Run tests via MCP
results = run-story-tests(
    stories=[{ "storyId": "button--primary" }],
    a11y=True
)
# 3. If failures: read violations, fix, retry (max 3)
# 4. Preview in chat for visual confirmation
preview-stories(stories=[{ "storyId": "button--primary" }])
```

### Setup

```bash
npx storybook add @storybook/addon-mcp   # current: 0.6.0, Apr 2026
# Enable docs toolset in .storybook/main.ts:
#   componentsManifest: true    # was experimentalComponentsManifest (SB 10.3 rename, default-on)
npx mcp-add --type http --url "http://localhost:6006/mcp" --scope project
```

See the Storybook mode of the `design-to-code` skill for full tool reference and patterns.

---

## References

- `references/storybook-migration-guide.md` — Migration path from Storybook 9 to 10
- `references/storybook-ci-strategy.md` — CI pipeline configuration for visual, interaction, and a11y testing
- `references/storybook-addon-ecosystem.md` — Essential addons for Storybook 10 in 2026

## Related Skills

- `design-to-code` (Storybook mode): Storybook MCP tools for component discovery, testing, previews
- `react-server-components-framework` — React 19 + Next.js 16 patterns (component architecture)
- `accessibility` — Broader accessibility patterns beyond Storybook
- `devops-deployment` — CI/CD pipeline patterns for automated testing

© OrchestKit · MIT · yonatangross/orchestkit

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

Все скиллы по теме «Тесты и QA» →
format-storybook podo Скилл format-storybook раскладывает файлы Storybook по одному шаблону: истории рядом с компонентами, общий template, args и контролы, документация в MDX. CX Codex +1 213установок storybook-stories oakoss Скилл storybook-stories создаёт истории Storybook и тесты взаимодействия в формате CSF3. Помогает изолированно разрабатывать интерфейсы, настраивать снимки Chromatic и тестировать доступность. CX Codex +1 124установок storybook pproenca Помогает настраивать Storybook и писать истории для TypeScript/React-компонентов. Описывает интерактивные тесты, проверку доступности и сборку документации. CX Codex +1 145установок writing-react-native-storybook-stories storybookjs Скилл writing-react-native-storybook-stories помогает агенту писать и править истории React Native по формату CSF: args, argTypes, декораторы, параметры аддонов и портируемые истории для тестов. CX Codex +1 722установок storybook-story-writing TheBushidoCollective Скилл storybook-story-writing для Claude Code: пишет и правит истории Storybook в формате CSF3, покрывает все состояния компонента и держит сборку без ошибок. Останавливает расползание сториз и поломку билда. CX Codex +1 680установок storybook-setup patricio0312rev Скилл storybook-setup настраивает Storybook для документации компонентов, интерактивных контролов, accessibility-проверок и визуальной регрессии. CX Codex +1 336установок

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

Весь набор →
animation-motion-design Скилл animation-motion-design для Claude Code с паттернами анимации интерфейсов на Motion и View Transitions API. Подключается при работе над переходами страниц, жестами и поддержкой prefers-reduced-motion. CX Codex +1 228установок web-research-workflow Скилл web-research-workflow для Claude Code выбирает способ загрузки веб-контента и извлекает страницы. Отслеживает изменения у конкурентов для исследований и мониторинга сайтов. CX Codex +1 228установок react-server-components-framework Скилл react-server-components-framework задаёт серверный подход к приложениям Next.js с React Server Components, App Router, кэшированием, потоковым SSR и Server Actions. CX Codex +1 227установок doctor Скилл doctor проверяет состояние компонентов OrchestKit, манифестов, хуков, субагентов и серверов MCP. Находит сбои конфигурации и подсказывает способы исправления перед релизом. CX Codex +1 227установок explore Скилл explore для Claude Code запускает 3–5 агентов, чтобы исследовать структуру кода, потоки данных, архитектурные паттерны и здоровье проекта. Разбирает незнакомую кодовую базу и её архитектуру. CX Codex +1 224установок errors Скилл errors разбирает ошибки сессий Claude Code, группирует их по типам и ищет повторяющиеся случаи. Он подключается к задаче после сбоя команды, сети или инструмента. CX Codex +1 223установок issue-progress-tracking Скилл issue-progress-tracking регламентирует ведение задач на GitHub через утилиту gh CLI: переводит статусы, создаёт ветки под задачу, фиксирует прогресс и привязывает pull request. CX Codex +1 221установок release-management Скилл release-management выпускает релизы на GitHub через gh release: подбирает версию по semver и собирает заметки из смёрдженных PR. Пригодится при тегировании и публикации changelog. CX Codex +1 220установок

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

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