minion-orchestrator

Routes shell and LLM subagent jobs through a durable queue with lifecycle controls.

1|Updated May 9, 2026
One-click install
npx skills add https://github.com/weiping/gbrain-cn --skill minion-orchestrator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: minion-orchestrator
Source: https://github.com/weiping/gbrain-cn/tree/main/skills/minion-orchestrator
Command: npx skills add https://github.com/weiping/gbrain-cn --skill minion-orchestrator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of reliably running and controlling background work—both deterministic shell commands and LLM subagent tasks—with durable progress tracking and restart safety.

Core Features & Use Cases

  • Unified job queue routing: Routes requests to deterministic shell jobs or LLM subagent jobs depending on whether the task needs a reasoning loop or reproducible command execution.
  • Durable, observable execution: Uses a Postgres-native Minions queue so jobs survive gateway restarts and expose structured progress, token accounting, and session transcripts.
  • Steerable job lifecycle: Supports pausing, resuming, cancelling, replaying, and steering running agents via inbox messages, including parent-child DAGs with failure policies.

Example use case: When you need to fan out parallel research and then consolidate results, submit an LLM subagent fan-out manifest so children run concurrently and an aggregator runs after completion, while you monitor and steer progress as it happens.

Quick Start

Submit an LLM subagent job for research and synthesis by asking your agent to run: "Research Acme Corp revenue and produce a cited summary, then tell me what key details are missing."

Frequently Asked Questions about minion-orchestrator

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

FAQPage Schema
How do I orchestrate background LLM subagent tasks with durable progress tracking?

You can orchestrate background LLM subagent tasks by routing them through a unified Minions queue, which provides durable progress tracking, token accounting, and session transcripts that survive gateway restarts.

Can I run deterministic shell jobs and LLM subagents in the same job queue?

Yes, routing policies direct requests to deterministic shell jobs or LLM subagent jobs depending on whether the task requires reproducible command execution or a reasoning loop.

How do I build a fan-out DAG for parallel research and consolidation tasks?

You can submit a fan-out manifest so child LLM subagents run concurrently, and an aggregator job executes after completion, while you monitor and steer progress via structured progress reporting.

How do I pause, resume, or cancel running background jobs safely?

Steerable job lifecycle control supports pausing, resuming, cancelling, and replaying running agents via inbox messages, including parent-child DAGs with specific failure policies.

Do I need MCP tool interfaces for job submission and monitoring?

Yes, the orchestration requires MCP tool interfaces for job CRUD and progress reporting to manage restart-safe execution and structured token reporting for shell and subagent routing.

What is the best way to monitor and steer running subagents during execution?

You can monitor and steer running agents via inbox messages while the system exposes structured progress, token accounting, and session transcripts through the unified queue interface.