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

storybook-rsbuild — скилл для Claude Code: настройка Storybook

Скилл storybook-rsbuild настраивает Storybook на Rsbuild или переносит существующий проект с webpack и Vite. Он также учитывает интеграции с Rslib, Modern.js и Rspack.

MIT 212 установок ★ 100 обновлён 2026-10-22

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

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

Скилл проверяет структуру проекта и package.json, чтобы определить, установлен ли уже Storybook и какой UI-фреймворк используется. Затем он помогает настроить свежую установку или перенести существующую на Rsbuild: подобрать пакет фреймворка, обновить .storybook/main.* и скрипты storybook dev и storybook build.

При миграции скилл сохраняет старые пакеты и настройки до проверки, а после успешной проверки удаляет прежний builder и связанные блоки конфигурации. Аддоны для webpack нужно передать через webpackAddons или заменить настройками для Rsbuild. В монорепозитории изменения ограничены пакетом, где лежат stories.

Для версий и команд установки скилл обращается к документации storybook.rsbuild.rs, поэтому ему нужен доступ к сети. Это важно: без него нельзя свериться с актуальными требованиями фреймворка.

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

  • настроить Storybook на Rsbuild для используемого UI-фреймворка
  • перенести Storybook с webpack или Vite на Rsbuild
  • обновить конфигурацию .storybook/main.*
  • сохранить webpack-аддоны при миграции

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

  • Настрой Storybook на Rsbuild для React в этом проекте.
  • Перенеси Storybook с Vite на Rsbuild и проверь конфигурацию.
  • Проверь интеграцию Storybook с Rslib в этом монорепозитории.

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

1Через Skills CLI (Vercel)

npx skills add rstackjs/agent-skills --skill storybook-rsbuild -a claude-code

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

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

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

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

Вопросы о storybook-rsbuild

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

Выполните npx skills add rstackjs/agent-skills --skill storybook-rsbuild -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/storybook-rsbuild/SKILL.md.

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

Скилл помогает установить Storybook на Rsbuild или перенести существующую конфигурацию с webpack либо Vite. Он также учитывает интеграции с Rslib, Modern.js и Rspack.

Нужен ли доступ к сети для storybook-rsbuild?

Да. Скилл читает документацию storybook.rsbuild.rs, чтобы сверять совместимость версий и инструкции по настройке.

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

SKILL.md · MIT
---
name: storybook-rsbuild
description: Set up or migrate Storybook to Rsbuild, configure rsbuildFinal, or integrate with Rslib, Modern.js, or Rspack.
compatibility: Requires network access to read upstream docs at storybook.rsbuild.rs
---

# Storybook Rsbuild

## Goal

Set up Storybook on Rsbuild, or migrate an existing Storybook to it. Factual mappings — version compatibility, package names, install commands, config conversion patterns — live in upstream docs at `storybook.rsbuild.rs`. This skill is an action router and a behavioral checklist; it does not duplicate the docs.

## Principles (must follow)

1. **Single source of truth is upstream.** Fetch the relevant `storybook.rsbuild.rs` page for version tables, install commands, and config conversion patterns. Do not infer version pins or package names from training memory — the ecosystem moves faster than the model's prior.

2. **Pin from the framework guide's Requirements table.** Each framework guide page (e.g. `https://storybook.rsbuild.rs/guide/framework/react`) carries a Requirements section listing the canonical compatible version ranges — that is the authoritative source for version pins. For fresh setups, install the latest stable `storybook` major and the matching `storybook-rsbuild` major. Do not pin from version numbers you see in code snippets elsewhere; only the docs are authoritative.

3. **Declare `@rsbuild/core` directly.** `storybook-<framework>-rsbuild` lists `@rsbuild/core` as a peer dependency, but you must still add `@rsbuild/core` to the project's own `devDependencies` so version pins and lockfile audits remain unambiguous and a future framework-package release that drops the peer cannot silently break the build.

4. **Migration is one task with two ordered phases — both required.** Phase A: install the new framework package and update config; leave the old framework package, old builder package, and old `webpackFinal` / `viteFinal` blocks in place so [Verification](#verification) has a rollback path. Phase B: as soon as Verification passes, in the same task, remove the old framework package (e.g. `@storybook/react-webpack5`, `@storybook/vue3-vite`), the old builder package (e.g. `@storybook/builder-webpack5`, `@storybook/builder-vite`), and the old `webpackFinal` / `viteFinal` block. A migration that ends with both builders' framework packages still in `package.json` is incomplete — leaving them is the most common silent regression in this skill's evals. Phase A on its own is not a valid stopping point; if you ran Verification, you must also run cleanup.

5. **Preserve addons; never silently drop.** When migrating, webpack-only addons (e.g. `@storybook/addon-styling-webpack`) must either be passed through `webpackAddons` (so upstream auto-translation handles them) or replaced with the equivalent Rsbuild-native pipeline (`@rsbuild/plugin-postcss`, `tools.postcss`, etc.). A migration that removes a styling addon and produces a passing `storybook build` but a visually broken story tree is still a regression.

6. **Operate in scope.** In monorepos, modify only the package that hosts stories. Do not edit business source files unless the migration strictly requires it.

## Step 1 — detect scenario

Read `package.json` and project structure to determine existing Storybook state:

1. Check for `.storybook/` directory (in monorepos, check both root and per-package)
2. Check `package.json` for `storybook` scripts or `@storybook/*` / `storybook-*-rsbuild` in dependencies or devDependencies
3. If Storybook exists **and already uses `storybook-*-rsbuild`** → already set up; go to [Configuration](#configuration) or [Troubleshooting](#troubleshooting) as needed
4. If Storybook exists **with a non-Rsbuild builder** (`@storybook/*-webpack5`, `@storybook/*-vite`, etc.) → go to [Migration Workflow](#migration-workflow)
5. **No Storybook found** → go to [Fresh Setup Workflow](#fresh-setup-workflow)

---

## Fresh setup workflow

### 1. Detect ecosystem integration

Read `package.json` dependencies and devDependencies, check in order:

| Signal                                 | Ecosystem   | Integration guide                                        |
| -------------------------------------- | ----------- | -------------------------------------------------------- |
| `@rslib/core`                          | Rslib       | https://storybook.rsbuild.rs/guide/integrations/rslib    |
| `@modern-js/app-tools`                 | Modern.js   | https://storybook.rsbuild.rs/guide/integrations/modernjs |
| `@rspack/core` without `@rsbuild/core` | Pure Rspack | https://storybook.rsbuild.rs/guide/integrations/rspack   |

If matched, read the integration guide and **apply its constraints as an overlay** alongside the steps below.

### 2. Detect UI framework

Infer the UI framework from app dependencies (`react`, `vue`, `lit`, etc.):

| UI Framework     | Framework package                    | Guide                                                         |
| ---------------- | ------------------------------------ | ------------------------------------------------------------- |
| React            | `storybook-react-rsbuild`            | https://storybook.rsbuild.rs/guide/framework/react            |
| Vue 3            | `storybook-vue3-rsbuild`             | https://storybook.rsbuild.rs/guide/framework/vue              |
| Vanilla JS/TS    | `storybook-html-rsbuild`             | https://storybook.rsbuild.rs/guide/framework/vanilla          |
| Web Components   | `storybook-web-components-rsbuild`   | https://storybook.rsbuild.rs/guide/framework/web-components   |
| React Native Web | `storybook-react-native-web-rsbuild` | https://storybook.rsbuild.rs/guide/framework/react-native-web |

### 3. Set up Storybook

1. In monorepos, operate in the package that will host stories
2. Read and follow the framework guide matched above; install the **latest stable** `storybook` major and the matching `storybook-<framework>-rsbuild` major (Principle 2)
3. Add `@rsbuild/core` to `devDependencies` directly, alongside `storybook-<framework>-rsbuild` (Principle 3)
4. Ensure `.storybook/main.*` uses the correct `framework: '<storybook-*-rsbuild>'`
5. Ensure `package.json` has `storybook dev` and `storybook build` scripts
6. If no story file exists yet, scaffold at least one minimal example story (e.g. `src/stories/Example.stories.*`) so [Verification](#verification) step 2 has something to render
7. Run [Verification](#verification) below

## Migration workflow

Read the upstream migration guide: https://storybook.rsbuild.rs/guide/migration

Follow these steps **in order**:

1. **Detect migration type** — read `.storybook/main.*` (`framework` field and/or `core.builder`) and `package.json` dependencies to classify as "from webpack5" or "from Vite", then select the matching section in the migration guide
2. **Resolve version compatibility** — read the "Version compatibility" section in the migration guide, select the correct `storybook-rsbuild` major based on installed Storybook version
3. **Replace packages** — apply the install/remove mapping from the migration guide using the project's package manager (detect from lockfile); only change packages required by the migration. Always add `@rsbuild/core` as a direct devDep alongside the new framework package (Principle 3). Do not remove the old framework package or old devDeps yet — that happens after Verification (Principle 4)
4. **Update `.storybook/main.*`** — apply the config changes exactly as shown in the migration guide for the detected framework
5. **Migrate custom builder hooks** — search for legacy builder hooks (`webpackFinal` / `viteFinal`); if found, convert following the upstream configuration guide (https://storybook.rsbuild.rs/guide/configuration)
6. **Handle addon compatibility** — keep addons unchanged initially. If a webpack-only addon must change, route it through `webpackAddons` for upstream auto-translation, or replace it with the Rsbuild-native equivalent — never silently drop it (Principle 5). Consult the migration guide's addon section for the recommended fix
7. **Verify, then clean up — both required** — run [Verification](#verification) below; once it passes, in the same task complete all of the following before reporting done (Principle 4):
   - Remove the old framework package from `package.json` devDependencies (e.g. `@storybook/react-webpack5`, `@storybook/vue3-webpack5`, `@storybook/react-vite`, `@storybook/vue3-vite`, `@storybook/html-webpack5`, `@storybook/web-components-webpack5`, etc.)
   - Remove the old builder package if separately listed (e.g. `@storybook/builder-webpack5`, `@storybook/builder-vite`)
   - Delete the legacy `webpackFinal` / `viteFinal` block from `.storybook/main.*`
   - Drop any old-builder-only devDeps that no longer have consumers
   - Re-run `pnpm install` (or the project's package manager equivalent) so the lockfile reflects the cleanup

If a factual mapping is needed (version table, package names, conversion patterns) and not present in this skill, fetch it from the upstream docs — do not guess.

---

## Verification

1. `storybook dev` starts without errors
2. At least one story renders correctly in the browser (a clean dev-server boot is not sufficient — a missing-glob in `stories` or a broken framework wiring will only surface here)
3. HMR works
4. `storybook build` completes
5. Check startup logs to confirm the Rsbuild builder is active (not webpack/vite)

## Troubleshooting

- **Cache issues**: remove `node_modules/.cache/storybook` and retry
- **Residual config**: if dev fails after migration, temporarily remove custom `rsbuildFinal` block to isolate the issue, then re-add incrementally
- For debugging and other issues, consult the upstream migration guide's "Debugging" section and https://storybook.rsbuild.rs/guide/configuration

## Edge cases

- **Monorepo**: locate the package that hosts stories; operate there, not at root
- **Multiple `.storybook/` dirs**: pick the one referenced by `package.json` scripts
- **TS path aliases**: ensure aliases are preserved after migration; consult the upstream configuration guide for how to configure `rsbuildFinal`

## Configuration

For `rsbuildFinal`, builder options, TypeScript, and framework-specific options → read https://storybook.rsbuild.rs/guide/configuration

© rstackjs · MIT · rstackjs/agent-skills

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

Все скиллы по теме «Фронтенд и UI» →
storybook Mindrally Задаёт правила создания историй, автодокументации и тестов компонентов в Storybook. Помогает поддерживать дизайн-систему в проектах на React. CX Codex +1 970установок 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установок setup-react-native-storybook storybookjs Скилл setup-react-native-storybook автоматизирует развёртывание Storybook 10 в проектах на React Native. Помогает настроить окружение для Expo, чистого React Native CLI или Re.Pack. CX Codex +1 562установок storybook-setup patricio0312rev Скилл storybook-setup настраивает Storybook для документации компонентов, интерактивных контролов, accessibility-проверок и визуальной регрессии. CX Codex +1 336установок storybook-stories Pedro Nauck Скилл storybook-stories пишет и правит Storybook-сторис, опираясь на конвенции вашего репозитория. Полезен, когда сторис много, а правила именования и декораторов нигде толком не записаны. CX Codex +1 317установок

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

Весь набор →
rspress-docs-generator Скилл rspress-docs-generator разворачивает сайт документации на Rspress v2 или обновляет существующие страницы под изменения в коде, тестах и API. CX Codex +1 344установок migrate-to-rsbuild Скилл migrate-to-rsbuild переводит фронтенд-проекты с webpack, Vite, Create React App и Vue CLI на сборщик Rsbuild. Он пошагово заменяет конфигурацию и проверяет запуск перед удалением старых пакетов. CX Codex +1 342установок rspack-tracing Скилл rspack-tracing для Claude Code и других IDE захватывает и анализирует traces сборок Rspack, чтобы найти медленные фазы компилятора, плагины и лоадеры. Помогает диагностировать крахи и узкие места прямо в процессе разработки. CX Codex +1 291установок rspack-debugging Скилл rspack-debugging для Claude Code снимает через LLDB состояние краша нативного Rspack и собирает бэктрейсы при segfault, дедлоке или зависшей сборке. CX Codex +1 282установок migrate-to-rslib Скилл migrate-to-rslib переводит сборку библиотек с tsc или tsup на Rslib с проверкой билда и сохранением исходного кода. CX Codex +1 201установок rspack-split-chunks Скилл rspack-split-chunks помогает агенту диагностировать и настраивать optimization.splitChunks в Rspack: найти дубликаты модулей, избыточную загрузку, проблемы кеширования и слишком большие чанки. CX Codex +1 187установок rspress-v2-upgrade Скилл rspress-v2-upgrade автоматизирует переход Rspress-проекта с версии 1 на версию 2. Читает конфиг, обновляет зависимости, меняет импорты и валидирует результат по официальному гайду. CX Codex +1 150установок rstest-debugging Скилл rstest-debugging помогает найти причину проблем Rstest со стартом, сборкой, рантаймом, логами, памятью и производительностью по трассам и сопоставимым замерам. CX Codex +1 133установок

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

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