worker-pipeline-triage

Diagnose and localize failures in background worker pipelines across queueing systems.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/ringlochid/coding-skills --skill worker-pipeline-triage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worker-pipeline-triage
Source: https://github.com/ringlochid/coding-skills/tree/main/worker-pipeline-triage
Command: npx skills add https://github.com/ringlochid/coding-skills --skill worker-pipeline-triage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and localize failures in asynchronous worker pipelines, including producer, broker, worker, queue, scheduler, and results paths.

Core Features & Use Cases

  • Confirm producer, broker, worker, queue, result path, and scheduler/beat when present.
  • Inspect registration/routing/config before changing code.
  • Check retries, idempotence, serialization, and stale worker code.
  • Verify with one representative task when possible.
  • Route to implementation only after the broken segment is clear.

Quick Start

Provide a representative failing task path in your async pipeline and let the skill guide you to the suspected broken segment.

Frequently Asked Questions about worker-pipeline-triage

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

FAQPage Schema
How do I diagnose why my async worker pipeline is not processing jobs?

To diagnose an async worker pipeline not processing jobs, verify producer, broker, worker, queue, and scheduler configurations step by step. This method inspects registrations, routing, and config to localize the broken segment.

What causes background tasks to fail silently in a worker queue system?

Background tasks fail silently in worker queue systems due to incorrect routing, serialization mismatches, or stale worker code. Stepwise verification of registrations, routing, and idempotence helps pinpoint the exact failure point.

How do I troubleshoot a scheduler that is not publishing results correctly?

Troubleshooting a scheduler not publishing results correctly requires checking the scheduler or beat configurations and the results path. Verify routing and serialization to ensure scheduled jobs complete and publish properly.

How do I fix a worker queue that fails to retry failed jobs properly?

Fixing a worker queue that fails to retry jobs properly involves inspecting retry configurations and idempotence settings. Verify that worker code is not stale and that the broker routes retry commands correctly.

Can I use this triage method for any async runtime and queueing system?

Yes, this triage method applies to multiple queueing systems and async runtimes. It focuses on verifying the producer to results path generically, confirming registrations and config before routing to implementation.