fan-out

Run parallel subagents on one work unit and reconcile their results.

1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/pnewsam/skills --skill fan-out-pnewsam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fan-out
Source: https://github.com/pnewsam/skills/tree/main/registry/fan-out
Command: npx skills add https://github.com/pnewsam/skills --skill fan-out-pnewsam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? A single model pass can under-cover a broad surface or lock in the first design shape it finds. This Skill runs several independent subagents in parallel on one work unit — competing implementations, partitioned coverage, or multi-model review — and reconciles their outputs into one defensible result. ## Core Features & Use Cases - Arena mode: Spawn competing attempts at the same design or implementation brief in isolated worktrees, judge them on a different model family, and graft the strongest ideas into one chosen candidate. - Swarm mode: Partition a broad coverage matrix, race, or exploration into slices, with each worker returning a compact PASS / ISSUES / BLOCKED result aggregated into one report. - Interrogate mode: Send the same diff to several independent reviewers, including a different-lab frontier model, then reconcile findings by root cause with refutation counting as much as extension. - Use Case: Before shipping a high-consequence PR, fan the diff out to three reviewers from different model families, deduplicate their findings by root cause, drop unsupported claims, and return consolidated findings ordered by severity. ## Quick Start Use the fan-out skill to have three independent reviewers, including one from a different model family, review this diff and reconcile their findings.

Frequently Asked Questions about fan-out

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

FAQPage Schema
How do I run parallel subagents for code review?▼

Use interrogate mode: send the same diff, intent, and context to several independent reviewers, each blind to the others, then reconcile findings by root cause. Include at least one different-lab frontier model and disclose the models used.

What is the difference between arena, swarm, and interrogate modes?▼

Arena runs competing attempts at the same brief and grafts the best ideas into one candidate. Swarm partitions a broad surface into slices for parallel coverage. Interrogate has several independent reviewers examine the same artifact and reconciles their findings.

When should I not use parallel fan-out?▼

Skip fan-out for routine, well-understood changes a single pass handles, since a frontier model on a small diff is already at ceiling. Fan-out pays off with scale: large surfaces, complex or high-consequence PRs, and wide design spaces.

Does parallel review work without a subagent substrate?▼

The runbook requires a subagent or workflow substrate with parallel workers and result aggregation. Without one, run the closest sequential approximation and state the limitation rather than claiming a parallel result.

Why use a different-lab model for review diversity?▼

A frontier model from a different lab brings blind spots the primary model does not share, while a cheaper same-family model adds false positives without new signal. Findings raised independently by two models carry higher confidence.