What problem does it solve?
This Skill condenses pg-boss v12 operational guidance into a developer-focused reference that reduces integration mistakes, misconfigured queues, and unreliable background processing in PostgreSQL-backed systems.
Core Features & Use Cases
- Work vs Fetch Patterns: Explains the differences between work() and fetch()/complete() lifecycles and when to use each for automatic or manual job control.
- Queue Configuration & Policies: Documents createQueue options, policy choices (standard, singleton, stately, etc.), retry strategies, heartbeat and expiration settings, and retention semantics.
- Scheduling, Throttling & Chaining: Covers cron scheduling constraints, singleton/debounce/throttle behaviors, job chaining patterns for pipelines, and dead-letter considerations.
- Use Case: Reliable media processing pipelines (probe → transcode → thumbnail), scheduled maintenance jobs, and throttled notification systems with proper heartbeat, retry, and monitoring settings.
Quick Start
Register queues with explicit options, attach an error listener to the boss EventEmitter, and implement work() handlers that destructure the jobs array and dispatch follow-up jobs with boss.send().