job-worker-orchestration

Coordinate repository job systems with idempotency, retries, and observability.

1|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/velcrafting/codex-skills --skill job-worker-orchestration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: job-worker-orchestration
Source: https://github.com/velcrafting/codex-skills/tree/main/skills/backend/job-worker-orchestration
Command: npx skills add https://github.com/velcrafting/codex-skills --skill job-worker-orchestration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates background work safely by coordinating the repository's job system (queue/cron/worker) with explicit idempotency guarantees, bounded retries, and observable state to prevent duplicate work and ensure reliability.

Core Features & Use Cases

  • Idempotent job execution across retries to avoid duplicate effects.
  • Configurable retry/backoff with dead-letter handling for failure modes.
  • Observability through logs, metrics, and traces to monitor job health and performance.
  • Use Case: long-running or scheduled tasks that must survive restarts or system failures.

Quick Start

Configure a background job to execute idempotently with retry/backoff and full observability using the repo's job system.

Frequently Asked Questions about job-worker-orchestration

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

FAQPage Schema
How do I ensure idempotent background job execution across retries?

Idempotent background job execution across retries is ensured by defining a specific job contract and explicit idempotency strategy, preventing duplicate side effects when tasks are retried. This safely coordinates the repository's job system for asynchronous and scheduled tasks.

What is the best way to handle dead-letter queues for failed background jobs?

The best way to handle dead-letter queues for failed background jobs is to configure bounded retry and backoff policies with dedicated dead-letter handling. This isolates permanently failed tasks after exhausting retries, ensuring system reliability without blocking the worker queue.

How do I add observability to a scheduled job worker system?

Observability for a scheduled job worker system is added through comprehensive logs, metrics, and traces that monitor job health and performance. This instrumentation tracks the execution state of long-running tasks, making restart safety and failure modes visible.

Can I use this to orchestrate long-running tasks that must survive system restarts?

Yes, you can orchestrate long-running tasks that must survive system restarts because the skill coordinates the repository's job system with explicit state tracking and restart safety. This ensures reliable execution and prevents duplicate work during failure recovery.

Why does my asynchronous job system perform duplicate work during automatic retries?

Asynchronous job systems perform duplicate work during retries when they lack explicit idempotency guarantees and a defined job contract. Applying a bounded retry policy with idempotent execution coordinates the worker to safely prevent these duplicate side effects.