# svelte-storybook-troubleshoot

Слэш-команда разбирает типовые поломки Storybook в проектах на SvelteKit: ошибки сборки, неразрешённые модули, конфликты аддонов.

- команда · `type=command` · Claude Code · 118 установок
- Автор: davila7
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/svelte/svelte-storybook-troubleshoot.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/commands/svelte-storybook-troubleshoot

## Что делает

Команда подключает агента-специалиста по Storybook и SvelteKit. Он идёт по списку известных сбоев: ошибка `__esbuild_register_import_meta_url__ already declared` после перехода с v6 на v7, неразрешённые импорты `$lib` и `$app`, глобальные стили, которые не подхватываются в `preview.js`, переменные `PUBLIC_` в окружении Storybook.

Для модулей SvelteKit агент настраивает алиасы в `viteFinal` и заводит моки вроде `.storybook/mocks/app/stores.js` с writable-хранилищами `page`, `navigating`, `updated`. Отдельно разбираются конфликты версий аддонов: команда предлагает проверить дерево зависимостей через `npm ls @storybook/svelte` и обновить пакеты. Если у вас в проекте нестандартный путь к `vite.config.js`, его придётся прописать в опциях фреймворка самому — иначе алиасы не подхватятся.

Есть чек-лист отладки: версии, конфигурация фреймворка, необходимость моков, Vite, совместимость аддонов, изоляция, консоль браузера, вывод сборки. По ходу разбора агент фиксирует найденное решение, чтобы команда могла им воспользоваться.

## Установка

### Claude Code (родная платформа)

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --command svelte/svelte-storybook-troubleshoot
```

2. **Вручную: положить файлы**
- Файл: `.claude/commands/svelte-storybook-troubleshoot.md` — Вызов — /svelte-storybook-troubleshoot. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/svelte-storybook-troubleshoot.md` — Вызов — /prompts:svelte-storybook-troubleshoot. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/svelte-storybook-troubleshoot.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/svelte-storybook-troubleshoot.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/svelte/svelte-storybook-troubleshoot.md

## Когда брать
- убрать ошибку `__esbuild_register_import_meta_url__ already declared` после миграции Storybook
- настроить алиасы для `$lib` и `$app` в конфиге Storybook
- замокать `$app/stores` для историй, которые не тянут реальный роутер
- подключить глобальные CSS и Tailwind в `preview.js`
- разобраться с конфликтом версий пакетов `@storybook/svelte` и `@storybook/sveltekit`

## Примеры запросов агенту
- Storybook не запускается, сыплет ошибками модулей — разберись
- Почему в Storybook не видны переменные PUBLIC_API_URL?
- Проверь конфиг Storybook в моём SvelteKit-проекте и почини сборку

## Похожие
- [svelte-code-writer](https://affpapa.org/nevibecode/skills/svelte-code-writer.md) — скилл · 12900 установок
- [sentry-svelte-sdk](https://affpapa.org/nevibecode/skills/sentry-svelte-sdk.md) — скилл · 2100 установок
- [svelte](https://affpapa.org/nevibecode/skills/claude-mpm-team-svelte.md) — скилл · 343 установки
- [writing-react-native-storybook-stories](https://affpapa.org/nevibecode/skills/writing-react-native-storybook-stories.md) — скилл · 681 установка
- [storybook-story-writing](https://affpapa.org/nevibecode/skills/storybook-story-writing.md) — скилл · 673 установки
- [setup-react-native-storybook](https://affpapa.org/nevibecode/skills/setup-react-native-storybook.md) — скилл · 526 установок

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 205 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md