workers-vitest-pool

Automates Vitest 4 and pool-workers setup and migration for Cloudflare Workers.

16|4|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/rianvdm/product-ai-public --skill workers-vitest-pool
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workers-vitest-pool
Source: https://github.com/rianvdm/product-ai-public/tree/main/.opencode/skills/workers-vitest-pool
Command: npx skills add https://github.com/rianvdm/product-ai-public --skill workers-vitest-pool

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Set up or upgrade vitest tests for Cloudflare Workers using @cloudflare/vitest-pool-workers. Use when scaffolding tests in a new Worker, when an existing Worker is on pool-workers <0.13 (vitest 2/3) and needs to upgrade, or when the test suite hits "Isolated storage failed" / "Expected .sqlite, got .sqlite-shm" errors. Pins the modern stack (vitest 4 + pool-workers ≥0.15 + Node 22) and documents the v2→v4 migration recipe.

Core Features & Use Cases

  • Known-good setup for new projects: pin modern stack from day one.
  • Migration path for existing projects: upgrade steps from older pool-workers to Vitest 4.
  • Clear configuration guidance for TS, tests, and CI.

Quick Start

Follow the migration and setup steps to bootstrap a new Worker test suite with vitest-pool-workers.

Frequently Asked Questions about workers-vitest-pool

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up vitest tests for a new Cloudflare Worker?

To set up vitest tests for a new Cloudflare Worker, pin the modern stack from day one using vitest 4, pool-workers ≥0.15, and Node 22, then apply the known-good configuration patterns for TypeScript and CI.

How do I migrate Cloudflare Workers from older pool-workers to Vitest 4?

Migrating Cloudflare Workers from older pool-workers to Vitest 4 requires following a known-good v2→v4 migration recipe to upgrade legacy versions and align with the modern pool-workers ≥0.15 requirement.

Why does isolated storage fail with an expected .sqlite got .sqlite-shm error in vitest-pool-workers?

The 'Isolated storage failed' and 'Expected .sqlite, got .sqlite-shm' errors in vitest-pool-workers occur due to per-test storage isolation issues, which require upgrading to the modern stack configuration to resolve.

What Node and Vitest versions are required for testing Cloudflare Workers?

Testing Cloudflare Workers with vitest-pool-workers requires Node 22, Vitest 4, and pool-workers version 0.15 or higher to ensure a reliable setup and avoid legacy isolation issues.

Does vitest-pool-workers support upgrading legacy versions below 0.13?

Yes, vitest-pool-workers supports upgrading legacy versions below 0.13 by applying a documented migration recipe that transitions existing Workers from Vitest 2 or 3 to the modern Vitest 4 stack.