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

vitest-testing · oakoss — скилл для Claude Code: что делает и как установить

Скилл vitest-testing обучает агента писать модульные, компонентные и интеграционные тесты на Vitest. Помогает настроить моки, проверять хуки и тестировать компоненты.

MIT 226 установок ★ 29 обновлён 2026-08-17

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

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

Скилл добавляет в контекст агента шаблоны и правила работы с фреймворком Vitest. Ассистент перестаёт выдумывать устаревший синтаксис Jest и пишет проверки с учётом нативной поддержки ESM. В набор входят конструкции для структурирования тестов через describe и it, параметризованные запуски, а также мягкие проверки expect.soft.

Внутри собраны практические паттерны для моков через vi.fn, vi.mock и подмены глобальных объектов. Отдельный блок посвящён связке с React Testing Library. Агент применяет правильные методы поиска элементов по роли доступности, оборачивает события в userEvent.setup и корректно тестирует хуки с помощью renderHook. Никаких лишних ручных вызовов act.

Инструмент рассчитан только на модульный и интеграционный уровень. Проводить через него сквозное тестирование браузера или нагрузочные испытания бессмысленно: для таких сценариев автор рекомендует брать Playwright.

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

  • написать модульные тесты для утилит и функций
  • протестировать кастомный React-хук через renderHook
  • настроить изоляцию модулей с помощью vi.mock и vi.spyOn
  • проверить асинхронные изменения в интерфейсе без гонок

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

  • Напиши юнит-тесты на Vitest для функции расчёта корзины и замокай обращение к API.
  • Покрой тестами React-компонент формы авторизации с проверкой доступности через роль кнопки.
  • Протестируй хук управления состоянием через renderHook и проверь обновление параметров.

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

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill vitest-testing -a claude-code

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

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

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

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

Вопросы о vitest-testing

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

Выполните команду npx skills add oakoss/agent-skills --skill vitest-testing -a claude-code. Файл конфигурации сохранится по пути ~/.claude/skills/vitest-testing/SKILL.md.

Что делает скилл vitest-testing?

Он предоставляет агенту правила и готовые сниппеты для фреймворка Vitest. Модель учится корректно настраивать моки, тестировать компоненты React и избегать типичных ошибок с асинхронным кодом.

Подходит ли vitest-testing для сквозных тестов?

Нет, скилл сфокусирован на компонентных, интеграционных и модульных тестах. Для сквозного тестирования сценариев в браузере автор советует использовать Playwright.

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

SKILL.md · MIT
---
name: vitest-testing
description: |
  Vitest testing framework for unit, component, and integration tests. Covers test structure (describe/it/test.each), assertions with expect, lifecycle hooks, mocking (vi.fn/vi.mock/vi.spyOn), React Testing Library patterns, hook testing with renderHook, user-event interactions, async utilities, configuration, workspace setup, coverage, and advanced patterns like in-source testing and concurrent execution. Also covers CLI commands, test filtering, tags, sharding, fixtures with test.extend, and fixture scoping.

  Use when writing unit tests, component tests, integration tests, or testing React hooks. Use for test configuration, mocking modules, testing async behavior, snapshot testing, or setting up test coverage.
license: MIT
metadata:
  author: oakoss
  version: '1.2'
  source: 'https://vitest.dev/'
user-invocable: false
---

# Vitest Testing

## Overview

Vitest is a Vite-native unit testing framework that shares the same configuration and plugin ecosystem. Built for speed with native ESM support, hot module replacement for tests, and parallel execution.

**When to use:** Unit tests, component tests, integration tests, hook tests, in-source tests. Testing React components with React Testing Library. Testing TanStack Query/Router/Form patterns.

**When NOT to use:** End-to-end testing (use Playwright), visual regression testing (use Percy/Chromatic), load testing (use k6).

## Quick Reference

| Pattern             | API                                             | Key Points                          |
| ------------------- | ----------------------------------------------- | ----------------------------------- |
| Test structure      | `describe('suite', () => {})`                   | Organize related tests              |
| Single test         | `test('behavior', () => {})` or `it()`          | Both are aliases                    |
| Parameterized tests | `test.each([...])('name', (arg) => {})`         | Run same test with different inputs |
| Concurrent tests    | `test.concurrent('name', async () => {})`       | Run tests in parallel               |
| Skip test           | `test.skip('name', () => {})` or `skipIf(cond)` | Conditionally skip tests            |
| Only test           | `test.only('name', () => {})`                   | Run specific test for debugging     |
| Assertions          | `expect(value).toBe(expected)`                  | Compare primitive values            |
| Deep equality       | `expect(obj).toEqual(expected)`                 | Compare objects/arrays              |
| Async assertions    | `await expect(promise).resolves.toBe(value)`    | Test promise resolution             |
| Before each test    | `beforeEach(() => {})`                          | Setup before each test              |
| After each test     | `afterEach(() => {})`                           | Cleanup after each test             |
| Mock function       | `vi.fn()`                                       | Create spy function                 |
| Mock module         | `vi.mock('./module')`                           | Replace entire module               |
| Spy on method       | `vi.spyOn(obj, 'method')`                       | Track calls to existing method      |
| Clear mocks         | `vi.clearAllMocks()`                            | Clear call history                  |
| Fake timers         | `vi.useFakeTimers()`                            | Control setTimeout/setInterval      |
| Render component    | `render(<Component />)`                         | Mount React component for testing   |
| Query by role       | `screen.getByRole('button')`                    | Find elements by accessibility role |
| User interaction    | `await user.click(element)`                     | Simulate user events                |
| Wait for change     | `await waitFor(() => expect(...))`              | Wait for async changes              |
| Find async element  | `await screen.findByText('text')`               | Query + wait combined               |
| Render hook         | `renderHook(() => useHook())`                   | Test custom hooks                   |
| Update hook props   | `rerender(newProps)`                            | Re-render hook with new props       |
| Snapshot            | `expect(value).toMatchSnapshot()`               | Compare against saved snapshot      |
| Inline snapshot     | `expect(value).toMatchInlineSnapshot()`         | Snapshot stored in test file        |
| CLI run once        | `vitest run`                                    | Single run, no watch                |
| Run changed tests   | `vitest --changed`                              | Tests affected by git changes       |
| Filter by name      | `vitest -t "pattern"`                           | Grep test names                     |
| Soft assertions     | `expect.soft(value).toBe(x)`                    | Continue on failure, collect all    |
| Poll assertions     | `await expect.poll(() => val).toBe(x)`          | Retry until passing                 |
| Test fixtures       | `const test = base.extend<F>({...})`            | Reusable setup via test.extend      |
| Hoisted mocks       | `vi.hoisted(() => ({ fn: vi.fn() }))`           | Variables for vi.mock factory       |
| Shard tests         | `vitest --shard 1/3`                            | Split across CI workers             |
| Tags                | `test('name', { tags: ['slow'] }, ...)`         | Filter with --tags-filter           |
| Stub globals        | `vi.stubGlobal('fetch', vi.fn())`               | Replace global objects cleanly      |

## Common Mistakes

| Mistake                                | Correct Pattern                                     |
| -------------------------------------- | --------------------------------------------------- |
| Using `getBy` for async content        | Use `findBy` or `waitFor` for async                 |
| Testing implementation details         | Test behavior and public API                        |
| Using `getByTestId` as first choice    | Prefer `getByRole`, `getByLabelText`, `getByText`   |
| Missing `userEvent.setup()`            | Always call `const user = userEvent.setup()` first  |
| Shared state between tests             | Use `beforeEach` to reset or create fresh instances |
| Not cleaning up mocks                  | Use `vi.clearAllMocks()` in `afterEach`             |
| Mocking too much                       | Only mock external dependencies and APIs            |
| Not disabling retries in tests         | Set `retry: false` for TanStack Query tests         |
| Immediate assertions on async          | Use `await waitFor()` or `findBy` queries           |
| Creating QueryClient in render         | Create once in wrapper or use `useState`            |
| Testing library code                   | Trust the library, test your usage                  |
| Not awaiting user events               | All `user.*` methods return promises                |
| Using `act` manually                   | `userEvent` and Testing Library handle this         |
| Inline select without memoization      | Extract to stable function for TanStack Query       |
| Variables in vi.mock factory           | Use `vi.hoisted()` to declare mock variables        |
| Single `expect` for multiple checks    | Use `expect.soft()` to collect all failures         |
| `setTimeout` in tests for async waits  | Use `expect.poll()` or `vi.waitFor()`               |
| Manual `beforeEach` for reusable setup | Use `test.extend` fixtures for composable setup     |

## Delegation

- **Test discovery**: For finding untested code paths, use `Explore` agent
- **Coverage analysis**: For full coverage review, use `Task` agent
- **E2E testing**: If `playwright` skill is available, delegate E2E testing to it
- **Code review**: After writing tests, delegate to `code-reviewer` agent

## References

- [Test fundamentals: structure, assertions, lifecycle hooks](references/test-fundamentals.md)
- [Mocking: vi.fn, vi.mock, vi.spyOn, module mocking](references/mocking.md)
- [Component testing: React Testing Library, queries, user-event](references/component-testing.md)
- [Hook testing: renderHook, async hooks, TanStack patterns](references/hook-testing.md)
- [Test setup: jest-dom matchers, cleanup, custom render, MSW, polyfills](references/test-setup.md)
- [Configuration: vitest.config.ts, workspace, coverage, reporters](references/configuration.md)
- [Advanced patterns: snapshots, concurrent tests, in-source, type testing](references/advanced-patterns.md)
- [CLI and filtering: commands, watch mode, tags, sharding](references/cli-and-filtering.md)
- [Fixtures and context: test.extend, scoping, auto fixtures, injection](references/fixtures-and-context.md)

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Тесты и QA» →

Сначала — vitest-testing от других авторов.

vitest-testing secondsky Скилл vitest-testing для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который добавляет знания о Vitest — фреймворке для юнит- и интеграционных тестов на TypeScript/JavaScript. CX Codex +1 1 300установок vitest-testing existential-birds Скилл vitest-testing для Claude Code: подсказывает, как писать тесты на Vitest — ассерты, моки, асинхронность, конфиг. Работает в проектах с уже установленным Vitest. CX Codex +1 473установок vitest-unit-testing przeprogramowani Правило vitest-unit-testing для Claude Code задаёт порядок написания юнит-тестов на Vitest. Помогает мокать модули и оформлять тесты компонентов. CX Codex +1 ★ 267звёзд репо vitest-testing-patterns curiositech Скилл vitest-testing-patterns задаёт шаблоны для написания тестов на Vitest и React Testing Library. Помогает генерировать проверки компонентов, роутов и мокировать внешние сервисы. CX Codex +1 373установок vitest-unit-testing-cursorrules-prompt-file PatrickJS Правило vitest-unit-testing-cursorrules-prompt-file для Cursor настраивает ИИ писать юнит-тесты на Vitest с TypeScript или JavaScript. Оно запускается на файлах проекта, мокает зависимости до импортов и группирует тесты в describe-блоки. CX Codex +1 ★ 41 178звёзд репо vitest pproenca Скилл даёт ИИ-агенту 44 правила для написания, отладки и ускорения тестов на Vitest. Помогает настроить моки, изолировать окружение и разобрать нестабильные проверки. CX Codex +1 7 800установок writing-tests spencerpauly Скилл writing-tests анализирует исходный код, определяет тестовый раннер и пишет юнит- или интеграционные тесты с моками и граничными случаями. CX Codex +1 550установок vitest-skill TestMu AI Генерирует юнит-тесты на Vitest для JavaScript и TypeScript проектов. Помогает настроить моки через vi и протестировать компоненты React. CX Codex +1 506установок

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

Весь набор →
application-security Скилл application-security разбирает код и архитектуру по OWASP Top 10 и STRIDE, даёт чек-лист перед деплоем и закрывает вопросы по GDPR, HIPAA, SOC 2 и PCI-DSS. CX Codex +1 287установок drizzle-orm Скилл передаёт агенту правила работы с Drizzle ORM, генерации схем для PostgreSQL, MySQL и SQLite, а также настройки миграций через drizzle-kit. CX Codex +1 263установок brand-designer Скилл brand-designer для Claude Code помогает собрать визуальную айдентику: от логотипа до бренд-гайда. Запускается по запросам о палитре, типографике и шаблонах для соцсетей. CX Codex +1 242установок tailwind Скилл помогает настраивать Tailwind CSS v4, собирать темы и компоненты, подключать dark mode и разбирать ошибки сборки. CX Codex +1 233установок content-humanizer Скилл content-humanizer переписывает черновик, который выдала модель, чтобы текст читался как написанный человеком: ритм фраз, тон, лишние оговорки. CX Codex +1 225установок zod-validation Скилл zod-validation учит агента синтаксису и правилам Zod v4 в TypeScript. Пригодится при составлении схем данных, валидации форм, парсинге API и конвертации схем в JSON Schema. CX Codex +1 222установок tanstack-form Помогает собирать формы на TanStack Form v1 в React и управлять их состоянием, валидацией и отправкой. Описывает работу со сложными и динамическими формами. CX Codex +1 222установок knowledge-graph-builder Скилл knowledge-graph-builder для Claude Code проектирует граф знаний, помогает выбрать графовую БД и связать обход графа с векторным поиском. Решает задачи Graph RAG и проверки фактов. CX Codex +1 222установок

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

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