minion-orchestrator

Orchestrate shell jobs and LLM subagent jobs through a durable queue.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Minions, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the orchestration of shell jobs and LLM subagents, ensuring durable, observable background work that can survive restarts and fan out across parallel tasks.

Core Features & Use Cases

  • Unified Minions Skill: Handles both deterministic shell jobs and LLM subagent orchestration.
  • Durable Work: Ensures jobs survive gateway restarts with Postgres-backed durability.
  • LLM Subagent Jobs: Supports open-ended reasoning, tool-using research, and fan-out synthesis.
  • Use Case: When you need to run a complex, multi-step task that involves both shell scripts and LLM-based subagents, such as automating data analysis that requires both script execution and reasoning.

Quick Start

Submit a shell job using the minion-orchestrator by running: gbrain jobs submit shell --params '{"cmd":"echo hello","cwd":"/abs/path"}'

Frequently Asked Questions about minion-orchestrator

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

FAQPage Schema
How do I orchestrate shell jobs and LLM subagents in parallel?

You can orchestrate shell jobs and LLM subagents in parallel using a unified queue system. The minion-orchestrator manages deterministic shell commands and open-ended LLM reasoning tasks, providing observable background execution and fan-out task synthesis.

What's the best way to run background tasks that survive gateway restarts?

To run background tasks that survive gateway restarts, use a Postgres-backed durability layer. This approach ensures queued shell jobs and LLM subagent work remain durable and observable across system restarts without losing execution state.

Do I need Minions to manage background LLM subagent jobs?

Yes, you need Minions installed and access to the Minions queue to manage background LLM subagent jobs. The orchestrator acts as a unified interface relying on this underlying queue to handle task submission and parallel execution.

How do I submit a shell job to a background task queue?

You submit a shell job to a background task queue by passing command parameters via CLI, such as `gbrain jobs submit shell --params`. Include your target command and working directory in the JSON payload to execute the deterministic script.

Can I steer running LLM subagents during parallel task execution?

Yes, you can steer running LLM subagents during parallel task execution. The orchestrator allows dynamic steering of active agents, enabling you to adjust open-ended reasoning and tool-using research while background work is in progress.