queue-worker-test
Installation
SKILL.md
Queue Worker Test
Generates tests for background job processors — verifying job execution, retry semantics, failure handling, and side effects without depending on a live queue broker.
Phase 1: Discovery
Extract before writing:
- Queue library — BullMQ, Bull (v3), SQS consumer, custom polling loop, or other?
- Test runner — Jest or Vitest?
- What the worker does — what side effects does a successful job produce? (DB write, HTTP call, email, etc.)
- Retry config — how many attempts? backoff strategy? Is it library-managed or custom?
- Failure behavior — does the worker move jobs to a dead-letter queue, emit an event, or just log?
- Concurrency — does the worker process jobs in parallel? (affects test isolation approach)
- Existing test infrastructure — is there already a DB test setup, mock HTTP layer, or job factory?