bullmq

Builds BullMQ 5.x background jobs with Redis-backed queues, workers, and FlowProducer pipelines.

15|2|Updated May 23, 2026
One-click install
npx skills add https://github.com/VKirill/antigravity-for-claude-code --skill bullmq-vkirill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bullmq
Source: https://github.com/VKirill/antigravity-for-claude-code/tree/main/skills/bullmq
Command: npx skills add https://github.com/VKirill/antigravity-for-claude-code --skill bullmq-vkirill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you build dependable background job processing on Node.js by covering the full BullMQ workflow—queues, workers, events, retries, scheduling, and production hardening—so jobs don’t get stuck, silently fail, or overload Redis.

Core Features & Use Cases

  • Queue & Worker design: Set up Queue, Worker, and QueueEvents correctly for cross-process observability and predictable job lifecycle handling.
  • Job reliability controls: Configure attempts, backoff, delay, priority, lifo, jobId idempotency, and safe cleanup via removeOnComplete / removeOnFail.
  • Production patterns: Implement graceful shutdown, stalled-job mitigation, dead-letter handling, sandboxed CPU work (useWorkerThreads or child processors), and safe Redis connection rules.
  • Flows & repeating jobs: Use FlowProducer for parent–child pipelines and queue.upsertJobScheduler for cron/every-N scheduling.

Quick Start

Ask Claude to “Design a BullMQ setup for a webhook-driven payment flow with a parent FlowProducer, child retries with backoff, idempotency via jobId, a DLQ for terminal failures, and a graceful shutdown plan for workers.”

Frequently Asked Questions about bullmq

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

FAQPage Schema
How do I set up reliable Redis background jobs with retries and dead-letter queues?

Reliable Redis background jobs require configuring BullMQ queues and workers with defined attempts, backoff strategies, and removeOnFail settings to route terminal failures to a dead-letter queue. This ensures jobs don't get stuck or silently fail during execution.

What is the correct Redis client configuration for BullMQ 5.x job scheduling?

BullMQ 5.x job scheduling requires a Redis client configuration with maxRetriesPerRequest set to null. This prevents the Redis client from failing commands during long polling operations, ensuring stable queue and worker connections for background processing.

How do I build parent-child job pipelines for webhook fan-out in Node.js?

Parent-child job pipelines for webhook fan-out are built using BullMQ's FlowProducer to orchestrate dependent job sequences. This allows parent jobs to spawn child jobs with individual retry policies and backoff, ensuring reliable multi-step asynchronous processing.

Can I schedule repeating cron jobs and apply rate limiting in BullMQ?

You can schedule repeating cron jobs and apply rate limiting in BullMQ by using queue.upsertJobScheduler for time-based triggers and configuring worker concurrency limits. This controls job throughput and prevents Redis overload during peak processing.

Why do my background jobs stall and how do I handle CPU-intensive tasks safely?

Background jobs stall when worker processes crash or block the event loop during CPU-intensive tasks. Handle this safely by enabling sandboxed CPU processing with useWorkerThreads or child processors, and implement stalled-job mitigation and graceful worker shutdown.

Does BullMQ support job idempotency and deterministic cleanup for production workloads?

BullMQ supports job idempotency by assigning a custom jobId to prevent duplicate queue entries, and ensures deterministic cleanup by configuring removeOnComplete and removeOnFail thresholds. This protects Redis from out-of-memory risks during high-volume processing.