vitest · paulrberg — скилл для Claude Code: что делает и как установить
Руководство для ИИ-агентов по написанию и отладке тестов на Vitest в проектах на Node, Bun или React.
MIT 186 установок ★ 107 обновлён 2026-10-24
npx skills add PaulRBerg/agent-skills --skill vitest -a claude-codeЧто делает vitest
Скилл задаёт агенту правила работы с тестами Vitest. Он запрещает самовольно включать глобальные переменные или режим jsdom. Существующий сетап репозитория определяет правила игры. Агент обязан сначала проверить конфигурацию проекта и соседние тесты.
При исправлении ошибок скилл требует подтвердить проблему упавшим тестом. Сначала падает тест. Моки изолируют только внешние системные границы, а логика тестируемого кода остаётся нетронутой. Для кодовых баз на Effect агент применяет инструменты @effect/vitest, включая it.effect и TestClock.
Запуск тестов ограничен минимальной целевой командой. Если готовый скрипт отсутствует в package.json, агент использует nlx vitest run. Результаты проверки фиксируются специальными заголовками регрессии или верификации.
Какие задачи решает
- написать модульные или компонентные тесты на Vitest под TypeScript
- воспроизвести ошибку упавшим тестом перед изменением кода
- изолировать внешние системные вызовы через моки Vitest
- организовать тесты для Effect с помощью
@effect/vitest
Примеры запросов агенту
- Напиши юнит-тесты на Vitest для функций парсера в файле
src/parser.ts. - Воспроизведи баг с расчётом скидки через падающий тест на Vitest.
- Запусти упавший тест минимальной проектной командой и покажи результат.
Как установить vitest
1Через Skills CLI (Vercel)
npx skills add PaulRBerg/agent-skills --skill vitest -a claude-code2Вручную: положить файлы
~/.claude/skills/vitest/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vitest/
1Через Skills CLI (Vercel)
npx skills add PaulRBerg/agent-skills --skill vitest -a codex2Вручную: положить файлы
.agents/skills/vitest/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add PaulRBerg/agent-skills --skill vitest -a cursor2Вручную: положить файлы
.cursor/skills/vitest/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install PaulRBerg/agent-skills skills/vitest2Вручную: положить файлы
.github/skills/vitest/SKILL.md1Через Skills CLI (Vercel)
npx skills add PaulRBerg/agent-skills --skill vitest -a gemini-cli2Командой платформы
gemini skills install https://github.com/PaulRBerg/agent-skills --path skills/vitestВручную: положить файлы
.devin/skills/vitest/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add PaulRBerg/agent-skills --skill vitest -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vitest
Как установить vitest в Claude Code?
Выполните команду npx skills add PaulRBerg/agent-skills --skill vitest -a claude-code. Также файл можно сохранить вручную по пути ~/.claude/skills/vitest/SKILL.md.
Что делает скилл vitest?
Он направляет агента при написании тестов: требует опираться на текущую конфигурацию проекта, изолировать моками границы систем и избегать лишних зависимостей.
Как скилл работает с проектами на Effect?
В репозиториях с Effect агент обязан использовать инструменты пакета @effect/vitest, включая it.effect, Layers и TestClock, вместо стандартных заглушек.
Исходный текст
SKILL.md · MIT
--- name: vitest description: "Use for Vitest in TypeScript projects (Node, bun, React/Next.js, Effect): write, run, or debug unit/component tests, mocks, testing utilities, and coverage." --- # Vitest Repository configuration, projects, setup, imports/globals, environments, aliases, test placement, and cleanup own the test contract. Inspect them and nearby tests before adding generic patterns. Do not add globals, jsdom, coverage, new setup, or browser mode by default. ## Workflow Define the behavior or regression. Test its observable public result. Mock system boundaries rather than the behavior under test. Follow local fixture and cleanup ownership. In Effect repositories, use established `@effect/vitest` conventions such as `it.effect`, Layers, and TestClock rather than generic replacements. For a bug fix, reproduce the failure before relying on a passing result when practical. Read [patterns](references/testing-patterns.md) for component, async, fixture, snapshot, tag, or browser questions. Read [mocking](references/mocking.md) for module, timer, spy, or global boundaries. Read [configuration](references/configuration.md) for projects, migration, coverage, or reporter selection. Read [troubleshooting](references/troubleshooting.md) for hangs, discovery, resolution, or flaky state. For test changes, run the narrowest established command for the changed behavior, then the affected package suite only when shared setup or contracts changed. Use `nlx vitest run` only when no project recipe or script exists. Reuse passing results until new edits, failures, or unresolved concerns justify another run. Completion requires a meaningful passing focused test under repository configuration and concise command/result evidence for test changes. A read-only explanation instead requires supporting configuration or API evidence. Do not add or run tests merely to satisfy the change workflow. When red-before-green evidence exists, use `### 🧪 Regression covered`. Otherwise, use `### 🧪 Tests verified` for executed tests.
© PaulRBerg · MIT · PaulRBerg/agent-skills
Похожие скиллы
Все скиллы по теме «Тесты и QA» →Сначала — vitest от других авторов.