parallelization

Guides parallel subagent dispatch and task isolation decisions for agent workflows.

Updated Apr 8, 2017
One-click install
npx skills add https://github.com/localmin/dotfiles --skill parallelization-localmin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: parallelization
Source: https://github.com/localmin/dotfiles/tree/main/coding-agents/skills/parallelization
Command: npx skills add https://github.com/localmin/dotfiles --skill parallelization-localmin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an AI agent receives a new task, it often processes everything serially in the main context, wasting time on independent subtasks and polluting the context with bulky search results. This Skill defines decision criteria for when to parallelize work across subagents, when to keep work inline, and how to avoid common pitfalls like biased self-evaluation and silently dropped dispatches. ## Core Features & Use Cases - Parallel Dispatch Criteria: Identifies independent subtasks (multi-scenario evaluation, multi-model comparison, independent searches) that should be dispatched to subagents in a single message. - Context Isolation Rules: Routes large-scale exploration (3+ grep/search queries) to general-purpose or Explore subagents so the main context only receives summaries, and mandates bias-free evaluation of your own outputs via fresh subagents. - Long-Running Batch Handling: Covers background execution with run_in_background, Monitor sandbox limitations (no gh access), and retry strategies when parallel dispatches are rejected by permission classifiers. - Use Case: You receive a request to review 20 repositories. Instead of scanning them one by one, you dispatch parallel subagents per repo, keep only summaries in the main context, and re-dispatch any rejected subtasks with rephrased prompts. ## Quick Start Read this Skill at the start of any new task and ask it to identify which subtasks can be parallelized or delegated to subagents before beginning work.

Frequently Asked Questions about parallelization

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

FAQPage Schema
How do I decide which tasks to run in parallel with subagents?

Dispatch tasks in parallel when you have two or more mutually independent subtasks, such as independent searches, multi-scenario evaluations, or multi-model comparisons. Avoid parallelizing serially dependent work where one task's output feeds the next.

When should I use a subagent instead of working in the main context?

Use a subagent for large-scale exploration involving three or more search or grep queries, and for bias-free evaluation of your own generated artifacts. Keep one-step lookups and short queries inline since dispatch overhead outweighs the benefit.

Why should I not evaluate my own generated output?

Self-evaluation introduces bias because you review your own work with the same context that produced it. Dispatch evaluation to a fresh subagent that does not share your context so the assessment stays independent.

What should I do when a parallel subagent dispatch is rejected?

Never silently drop a rejected subtask, since its inputs would quietly vanish from results. Re-dispatch only the rejected items once with a rephrased prompt, and if still blocked, explicitly tell the user which subtasks could not run.

Can the Monitor tool run gh commands for CI watching?

No. Monitor always runs inside a sandbox that denies reading ~/.config/gh, so gh fails at startup. Use run_in_background with dangerouslyDisableSandbox and an until loop for CI or remote state monitoring instead.

When should I avoid parallelizing a task?

Avoid parallelizing serially dependent steps, single-step or short lookups, and work that would duplicate effort between the main agent and subagents. Also confirm scope with the user before large fan-outs when their request is ambiguous.