skill-arch-background-jobs

Coordinate scheduled background jobs with cron, deduplication, and retries across BullMQ and Celery.

4|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/ryan-nguyen-01/agent-platform --skill skill-arch-background-jobs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-arch-background-jobs
Source: https://github.com/ryan-nguyen-01/agent-platform/tree/main/.claude/skills/skill-arch-background-jobs
Command: npx skills add https://github.com/ryan-nguyen-01/agent-platform --skill skill-arch-background-jobs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinate and execute reliable background jobs and scheduled tasks across distributed systems.

Core Features & Use Cases

  • Cron scheduling: Schedule recurring tasks with flexible timing, time zones, and retries.
  • Deduplication & idempotence: Prevent duplicate work and ensure safe replays or retries across workers.
  • Delayed & prioritized queues: Support delayed execution and priority-based processing to meet deadlines and SLA.
  • Dead-letter handling & retries: Route failed tasks to a dead-letter queue for later inspection and retry.
  • Cross-language support: Illustrates Node.js (BullMQ) and Python (Celery) implementations for real-world adoption.
  • Use Case: Daily report generation, order processing pipelines, and data synchronization across services.

Quick Start

Configure a queue (BullMQ or Celery), define a repeatable job, and start a worker to begin processing scheduled tasks.

Frequently Asked Questions about skill-arch-background-jobs

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

FAQPage Schema
How do I schedule recurring background jobs with retries and time zones in distributed systems?

To schedule recurring background jobs in distributed systems, configure a repeatable job definition using a queue system like BullMQ or Celery. This enables flexible cron scheduling with time zone support, deterministic timing, and automated retries for reliable task execution across workers.

What is the best way to prevent duplicate background jobs and ensure idempotent processing across multiple workers?

The best way to prevent duplicate background jobs and ensure idempotent processing is to implement job deduplication and distributed locking. This prevents overlapping work across workers and guarantees safe replays or retries without data corruption in distributed environments.

How do I handle failed background tasks and route them to a dead-letter queue for inspection?

Handle failed background tasks by configuring dead-letter queue routing within your job orchestration pipeline. This automatically isolates failed tasks for later inspection and manual or automated retries, ensuring fault-tolerant processing for workflows like order handling and data synchronization.

Can I implement delayed execution and priority queues for background processing using Node.js or Python?

Yes, you can implement delayed execution and priority queues using Node.js with BullMQ or Python with Celery. These frameworks support delayed execution and priority-based processing to help meet strict deadlines and service level agreements for background tasks.

When do I need distributed locks for background job deduplication in scheduled task workflows?

You need distributed locks for background job deduplication when multiple workers might attempt to process the same scheduled task concurrently. Locks enforce deterministic execution and maintain idempotence across distributed systems, preventing duplicate work during daily report generation or data synchronization.