minion-orchestrator

Orchestrate durable background shell and LLM subagent jobs via a Postgres-backed queue.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/ngochuy13/intern-dev --skill minion-orchestrator-ngochuy13
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: minion-orchestrator
Source: https://github.com/ngochuy13/intern-dev/tree/main/skills/minion-orchestrator
Command: npx skills add https://github.com/ngochuy13/intern-dev --skill minion-orchestrator-ngochuy13

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of reliably running background work that must survive restarts, remain observable, and be steerable while running, without forcing you to choose between deterministic scripts and LLM subagents upfront.

Core Features & Use Cases

  • Unified job routing: Orchestrates both deterministic shell jobs and LLM subagent jobs through one durable queue interface.
  • Steering and lifecycle control: Supports monitoring, pausing, resuming, canceling, and replaying jobs, including mid-flight redirection for running agents.
  • Parallel fan-out with DAGs: Enables parent-child task graphs with configurable failure handling and token/progress rollups.
  • Use case: You need to submit an ETL shell command and, in parallel, kick off an LLM research workflow that later consolidates results—while retaining progress, transcripts, and ability to steer ongoing work.

Quick Start

Ask your AI to submit a durable background job and return a running job ID so you can check progress and steer it as it executes.

Frequently Asked Questions about minion-orchestrator

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

FAQPage Schema
How do I run resilient background jobs that survive restarts and allow mid-flight steering?

You can run resilient background jobs by submitting them to a Postgres-backed durable queue that supports pausing, resuming, canceling, and replaying. This ensures long-running work remains observable and restart-safe while allowing mid-flight redirection for running agents.

Can I orchestrate deterministic shell commands and LLM subagents through the same job queue?

Yes, unified job routing allows you to orchestrate both deterministic shell commands and LLM subagent jobs through a single durable queue interface. This eliminates the need to choose between scripts and agents upfront when submitting background work.

What is the best way to execute parallel fan-out tasks with parent-child DAGs?

Executing parallel fan-out tasks with parent-child DAGs involves submitting a parent job that spawns child task graphs with configurable failure handling. The queue rolls up progress and tokens across the DAG, enabling consolidated results from complex workflows.

How do I monitor and control the lifecycle of a running background job?

You monitor and control a running background job by using lifecycle operations including get_job, list_jobs, pause_job, resume_job, and cancel_job. These mutating operations provide full visibility and steering capability over active execution.

Do I need Postgres to use durable job orchestration for long-running work?

Yes, durable job orchestration for long-running work requires a Postgres-backed queue interface to ensure persistence. This backing store enables restart-safe execution, progress tracking, and reliable message passing for steerable background tasks.

How do I replay a failed job or send messages to a running LLM subagent?

To replay a failed job or send messages to a running LLM subagent, use the replay_job and send_job_message operations provided by the orchestration interface. These allow you to retry failed work and steer active agents without restarting the entire workflow.