async-queue

What problem does it solve?

This Skill provides a standardized approach to running asynchronous background jobs reliably and safely, preventing duplicate executions and ensuring failed work is tracked and recoverable.

Core Features & Use Cases

• Idempotency: Use idempotency keys to avoid duplicate processing when clients retry requests.
• Retry Policy & Backoff: Exponential backoff with configurable max attempts and retryable error lists to handle transient failures.
• Dead Letter Queue & Observability: Move permanently failing jobs to a DLQ with full payload and error history for manual investigation and replay.
• Use Case: Enqueue long-running tasks like report generation, email delivery, or external API calls, return 202 Accepted with a job ID, and let workers process and update job status until completion.

Quick Start

Enqueue a job with an X-Idempotency-Key header, return 202 Accepted with a job ID, and poll the job status endpoint until the job completes.