.agents/skills/vitest/SKILL.md
Vitest fast unit testing framework powered by Vite with Jest-compatible API. Use when writing tests, mocking, configuring coverage, or working with test filtering and fixtures.
npx skillsauth add asymmetric-al/core vitestInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Vitest is a next-generation testing framework powered by Vite. It provides a Jest-compatible API with native ESM, TypeScript, and JSX support out of the box. Vitest shares the same config, transformers, resolvers, and plugins with your Vite app.
Key Features:
The skill is based on Vitest 3.x, generated at 2026-01-28.
| Topic | Description | Reference | | ------------- | --------------------------------------------------------------- | -------------------------------------------- | | Configuration | Vitest and Vite config integration, defineConfig usage | core-config | | CLI | Command line interface, commands and options | core-cli | | Test API | test/it function, modifiers like skip, only, concurrent | core-test-api | | Describe API | describe/suite for grouping tests and nested suites | core-describe | | Expect API | Assertions with toBe, toEqual, matchers and asymmetric matchers | core-expect | | Hooks | beforeEach, afterEach, beforeAll, afterAll, aroundEach | core-hooks |
| Topic | Description | Reference | | ------------ | -------------------------------------------------------------- | ---------------------------------------------------------- | | Mocking | Mock functions, modules, timers, dates with vi utilities | features-mocking | | Snapshots | Snapshot testing with toMatchSnapshot and inline snapshots | features-snapshots | | Coverage | Code coverage with V8 or Istanbul providers | features-coverage | | Test Context | Test fixtures, context.expect, test.extend for custom fixtures | features-context | | Concurrency | Concurrent tests, parallel execution, sharding | features-concurrency | | Filtering | Filter tests by name, file patterns, tags | features-filtering |
| Topic | Description | Reference | | ------------ | ------------------------------------------------------- | ------------------------------------------------------------ | | Vi Utilities | vi helper: mock, spyOn, fake timers, hoisted, waitFor | advanced-vi | | Environments | Test environments: node, jsdom, happy-dom, custom | advanced-environments | | Type Testing | Type-level testing with expectTypeOf and assertType | advanced-type-testing | | Projects | Multi-project workspaces, different configs per project | advanced-projects |
development
Use when working with Payload CMS projects (payload.config.ts, collections, fields, hooks, access control, Payload API). Use when debugging validation errors, security issues, relationship queries, transactions, or hook behavior.
testing
Use when CI tests fail on main branch after PR merge, or when investigating flaky test failures in CI environments
tools
Use when new translation keys are added to packages to generate new translations strings
data-ai
Pointer to the canonical agent instruction and skill system for this monorepo