Convex Test

If you're building on Convex and your tests are either missing or hitting a live deployment, this skill walks you through writing them against convex-test, an in-memory backend, using vitest as the runner. It covers the parts that usually get skipped: auth paths via withIdentity, error cases alongside the happy path, and scheduled functions, which you can flush with t.finishInProgressScheduledFunctions instead of waiting on real time. The workflow is simple: seed data with t.run, call your queries and mutations, assert on results. The main thing to watch is determinism. The skill steers you away from real clocks and network calls, which is the right call, but you'll still need to think about how your own functions read time. Worth running once on a function you already understand so you can judge the output.

skills.sh installs: 41.1K
GitHub stars: 69
last updated: Oct 26, 2026

View on GitHub

Install

$ npx -y skills add convex/agent-skills --skill convex-test --agent claude-code

Installs into .claude/skills of the current project.

Files

Generate Convex tests

Use convex-test + vitest to test functions against an in-memory backend: args/returns, auth paths, indexes, and scheduled functions.

Workflow

Install convex-test + vitest.
Write tests using convexTest(schema): seed via t.run, call t.query/t.mutation, assert.
Cover auth (withIdentity), error paths, and scheduled functions (t.finishInProgressScheduledFunctions).
Run vitest; keep tests deterministic.