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

storybook-mcp-integration — скилл для Claude Code: функции и установка

Скилл storybook-mcp-integration для Claude Code подключает инструменты Storybook MCP к работе с существующими компонентами. Агент ищет компоненты и их документацию, открывает предпросмотры и запускает тесты историй.

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

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

Что делает storybook-mcp-integration

Скилл помогает агенту изучать библиотеку компонентов через Storybook MCP: находить документацию и свойства компонентов, получать исходный код истории, открывать предпросмотры и запускать тесты с проверками доступности. Перед созданием нового компонента агент может проверить уже существующие истории.

Для работы нужен Storybook 10.3+ со сборщиком Vite и установленный @storybook/addon-mcp; для тестового набора требуется @storybook/addon-vitest. Поиск документации требует включённого componentsManifest в .storybook/main.ts. Подключение MCP-сервера в Claude Code выполняется командой npx mcp-add --type http --url "http://localhost:6006/mcp" --scope project. Для создания компонентов по макету предусмотрен отдельный скилл design-to-code.

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

  • найти существующие компоненты и их свойства
  • получить документацию и исходный код истории
  • показать предпросмотр истории компонента
  • запустить тесты историй и проверки доступности

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

  • Найди в Storybook существующие кнопки и покажи их свойства.
  • Открой предпросмотр истории Button/Primary.
  • Запусти тесты историй с проверкой доступности для новых компонентов.

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/storybook-mcp-integration/SKILL.md

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

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

Вопросы о storybook-mcp-integration

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

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

Что делает storybook-mcp-integration?

Скилл подключает агента к инструментам Storybook MCP для поиска компонентов и документации, просмотра историй и запуска тестов. Он предназначен для работы с существующими компонентами.

Что нужно для работы storybook-mcp-integration?

Нужен Storybook 10.3+ со сборщиком Vite и пакет @storybook/addon-mcp. Чтобы запускать тесты через MCP, установи @storybook/addon-vitest; для поиска документации включи componentsManifest в .storybook/main.ts.

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

SKILL.md · MIT
---
name: storybook-mcp-integration
license: MIT
compatibility: "Claude Code 2.1.277+. Optional: @storybook/addon-mcp (Storybook 10.3+, Vite-based only)."
description: "Storybook MCP server (@storybook/addon-mcp) tools and toolsets. Use when calling them on existing components. To build from a mockup, use design-to-code."
user-invocable: false
disable-model-invocation: false
targets:
  - library: storybook
    version: ">=10.6.1"
metadata:
  category: document-asset-creation
  mcp-server: storybook-mcp
  version: "1.0.0"
  author: "OrchestKit"
  complexity: "medium"
  tags: "storybook, mcp, component-discovery, story-preview, component-testing, a11y, design-system, react"
allowed-tools: "Read Glob Grep WebFetch WebSearch ToolSearch mcp__storybook-mcp__get-storybook-story-instructions mcp__storybook-mcp__preview-stories mcp__storybook-mcp__list-all-documentation mcp__storybook-mcp__get-documentation mcp__storybook-mcp__get-documentation-for-story mcp__storybook-mcp__run-story-tests"
paths:
  - ".storybook/**"
  - "src/**/*.stories.{ts,tsx}"
---

# Storybook MCP Integration

Use the Storybook MCP server (`@storybook/addon-mcp`) to give agents awareness of a project's actual component library — props, stories, tests, and live previews.

## When to Use

- **Component generation** — check existing Storybook components before creating new ones
- **Component testing** — run story tests + a11y audits via MCP instead of CLI
- **Visual verification** — embed story previews in chat for user confirmation
- **Component auditing** — inventory components with full metadata via MCP

## Quick Reference — 6 Tools, 3 Toolsets

| Toolset | Tool | Purpose | Key Inputs |
|---------|------|---------|------------|
| **dev** | `get-storybook-story-instructions` | Guidance on writing stories + interaction tests | none |
| **dev** | `preview-stories` | Returns preview URLs for stories (embeddable) | `stories[]: {storyId}` or `{absoluteStoryPath, exportName}` |
| **docs** | `list-all-documentation` | Full component + docs manifest index | none |
| **docs** | `get-documentation` | Props, first 3 stories, story index, docs | `id` (required), `storybookId` (optional) |
| **docs** | `get-documentation-for-story` | Full story source + component docs | `componentId`, `storyName` (required) |
| **testing** | `run-story-tests` | Run component + a11y tests, pass/fail + violations | `stories[]` (optional), `a11y` boolean (default true) |

## Prerequisites

```bash
# Storybook 10.3+ with Vite builder (no webpack)
npx storybook@latest upgrade

# Install the addon (current: @storybook/[email protected], Apr 2026)
npx storybook add @storybook/addon-mcp

# Enable docs toolset (required for component discovery)
# In .storybook/main.ts:
#   componentsManifest: true
# NOTE: the old `experimentalComponentsManifest` flag was renamed in
# Storybook 10.3; it is now `componentsManifest` and default-on. Any
# code still passing the `experimental` prefix will warn-then-ignore.

# For Chromatic remote setups, use the standalone package instead of
# the addon (same tool surface, no local Storybook required):
#   npm i -D @storybook/mcp
#   npx storybook-mcp --registry https://chromatic.storybook.cloud

# Enable testing toolset (requires addon-vitest)
# npx storybook add @storybook/addon-vitest

# Register with Claude Code
npx mcp-add --type http --url "http://localhost:6006/mcp" --scope project
```

## Detection Pattern

Before using Storybook MCP tools, check availability:

```python
# Probe for storybook-mcp tools
ToolSearch(query="+storybook list-all-documentation")

# If tools found → Storybook MCP is available
# If not found → fallback to filesystem-based component discovery
```

## Rule Details

Load rules on demand with `Read("rules/<file>")`:

| Rule | Impact | Description |
|------|--------|-------------|
| `component-discovery` | HIGH | Use list-all-documentation + get-documentation before generating new components |
| `story-preview-verification` | HIGH | Embed preview-stories URLs for visual confirmation |
| `mcp-test-runner` | CRITICAL | Run run-story-tests with a11y:true after component generation |

## Toolset Selection

Filter toolsets via `X-MCP-Toolsets` header to reduce agent context:

| Agent Role | Toolsets | Rationale |
|------------|----------|-----------|
| component-curator | `docs` | Inventory + props only, no testing |
| frontend-ui-developer | `dev,docs,testing` | Full access for gen → verify loop |
| design-system-architect | `docs` | Component metadata for governance |

## Chromatic Remote Publishing

For teams using Chromatic, the docs toolset is publishable remotely:
- Published at `https://<chromatic-storybook-url>/mcp`
- Only docs toolset available remotely (dev + testing need local Storybook)
- Useful for cross-team design system discovery without running Storybook locally

## Graceful Degradation

| Storybook MCP | Fallback | Behavior |
|---------------|----------|----------|
| Available | — | Use MCP tools for component discovery, testing, previews |
| Unavailable | Filesystem | `Glob("**/components/**/*.tsx")` + `Grep` for component inventory |
| Unavailable | 21st.dev | Search public registry via 21st-dev-magic MCP |
| Unavailable | Manual | Claude multimodal analysis of screenshots |

## Related Skills

- `storybook-testing` — CSF3 patterns, Vitest integration, Chromatic TurboSnap
- `component-search` — 21st.dev registry search (external components)
- `design-to-code` — Full mockup-to-component pipeline (uses this skill in Stage 2)
- `ui-components` — shadcn/ui + Radix component patterns

© OrchestKit · MIT · yonatangross/orchestkit

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
storybook Mindrally Задаёт правила создания историй, автодокументации и тестов компонентов в Storybook. Помогает поддерживать дизайн-систему в проектах на React. CX Codex +1 970установок storybook-story-writing TheBushidoCollective Скилл storybook-story-writing для Claude Code: пишет и правит истории Storybook в формате CSF3, покрывает все состояния компонента и держит сборку без ошибок. Останавливает расползание сториз и поломку билда. CX Codex +1 680установок storybook-play-functions TheBushidoCollective Скилл storybook-play-functions учит агента писать interaction-тесты внутри историй Storybook через функции play и библиотеку @storybook/test. CX Codex +1 119установок Storybook taste f Промпт Storybook taste для ChatGPT задаёт правила оформления историй компонентов в Storybook. Он описывает структуру файлов, состояния компонентов, проверки взаимодействий и публикацию историй для ревью. GP ChatGPT ★ 178 201звёзд репо writing-react-native-storybook-stories storybookjs Скилл writing-react-native-storybook-stories помогает агенту писать и править истории React Native по формату CSF: args, argTypes, декораторы, параметры аддонов и портируемые истории для тестов. CX Codex +1 722установок storybook-setup patricio0312rev Скилл storybook-setup настраивает Storybook для документации компонентов, интерактивных контролов, accessibility-проверок и визуальной регрессии. CX Codex +1 336установок

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

Весь набор →
golden-dataset Скилл golden-dataset для Claude Code описывает жизненный цикл эталонных датасетов: курацию, девятифазное добавление, регрессионные тесты и интеграцию с Langfuse. CX Codex +1 193установок mcp-patterns Скилл mcp-patterns для Claude Code и Codex помогает проектировать серверы Model Context Protocol. Включается при настройке транспортов, авторизации через OAuth, кэшировании ресурсов и защите от инъекций. CX Codex +1 191установок browser-tools Скилл browser-tools для Claude Code добавляет правила безопасности при автоматизации браузера через agent-browser: этику скрейпинга, паузы, обработку локальных URL и аутентификацию. Включается автоматически при такой работе. CX Codex +1 191установок scope-appropriate-architecture Скилл scope-appropriate-architecture определяет уровень проекта из шести и выбирает паттерны под его задачи, чтобы не строить микросервисы для MVP. Срабатывает в начале проектирования и при проверке сложности. CX Codex +1 179установок help Скилл help ищет установленный набор OrchestKit и показывает навыки по категориям. Запускается для выбора workflow или подходящего скилла. CX Codex +1 166установок business-case Скилл business-case считает ROI, NPV, IRR, срок окупаемости и TCO для инвестиционных решений. Запускается, когда агент собирает финансовое обоснование проекта или сравнивает build vs buy. CX Codex +1 162установок testing-e2e Скилл testing-e2e задаёт правила E2E-тестов на Playwright: выбор семантических локаторов, Page Objects и проверки axe-core. Включается при работе с тестами и playwright.config.*. CX Codex +1 160установок interaction-patterns Скилл interaction-patterns для Claude Code помогает выбирать паттерны взаимодействия в интерфейсе. Подключается при работе с загрузкой данных, пагинацией, оверлеями и уведомлениями. CX Codex +1 160установок

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

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