# Parallel Execution

Use when multiple subtasks have no shared files or dependencies and can be executed...

- Repository: https://github.com/darrenhinde/OpenAgentsControl (4967 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-26
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add darrenhinde/OpenAgentsControl --skill parallel-execution -g -a claude-code -y`
Codex: `npx skills add darrenhinde/OpenAgentsControl --skill parallel-execution -g -a codex -y`
Cursor: `npx skills add darrenhinde/OpenAgentsControl --skill parallel-execution -g -a cursor -y`
Gemini CLI: `npx skills add darrenhinde/OpenAgentsControl --skill parallel-execution -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add darrenhinde/OpenAgentsControl`

## Description

Use when multiple subtasks have no shared files or dependencies and can be executed simultaneously.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Parallel Execution

## Overview
Execute multiple independent tasks simultaneously using multiple subagent invocations in a single message. Reduces implementation time by 50-80% for multi-component features.

**Announce at start:** "I'm using parallel-execution to run [N] independent tasks simultaneously."

## The Process

### Step 1: Identify Parallel Tasks

Check subtask JSON files for `parallel: true`:

```bash
bash .opencode/skills/task-management/router.sh parallel {feature}
```

Output shows which tasks can run together:

```
Batch 1 (Ready now):
- subtask_01.json (parallel: true)
- subtask_02.json (parallel: true)

Batch 2 (After Batch 1):
- subtask_03.json (depends_on: ["01", "02"])
```

### Step 2: Execute Parallel Batch

Make multiple task() calls in SINGLE message:

```markdown
I'll execute Batch 1 tasks in parallel:

task(
  subagent_type="CoderAgent",
  description="Execute subtask 01",
  prompt="Read .tmp/tasks/feature/subtask_01.json and implement..."
)

task(
  subagent_type="CoderAgent",
  description="Execute subtask 02",
  prompt="Read .tmp/tasks/feature/subtask_02.json and implement..."
)
```

**CRITICAL**: Both task() calls in SAME message, not separate messages.

### Step 3: Wait for All to Complete

All tasks in batch must complete before proceeding to next batch.

### Step 4: Verify Batch Completion

```bash
bash .opencode/skills/task-management/router.sh status {feature}
```

Check all tasks in batch marked `status: "completed"`.

### Step 5: Execute Next Batch

Once Batch 1 complete, proceed to Batch 2:

```markdown
task(
  subagent_type="CoderAgent",
  description="Execute subtask 03",
  prompt="Read .tmp/tasks/feature/subtask_03.json and integrate..."
)
```

## Example: Converting Multiple Files

```markdown
I'll convert these 5 subagent files in parallel:

task(subagent_type="CoderAgent", description="Convert auth-agent",
     prompt="Convert .opencode/agent/subagents/auth-agent.md to new format...")

The rest: https://github.com/darrenhinde/OpenAgentsControl/blob/HEAD/plugins/claude-code/skills/parallel-execution/SKILL.md