# oz-child-agent-orchestration

oz-child-agent-orchestration is a Claude Code skill for coordinating a child run with its lead through the Oz CLI. The Oz harness system prompt controls when it runs.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 720 repo stars
- Author: dominikmartn
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dominikmartn/harp/tree/HEAD/resources/bundled/harness_skills/oz-child-agent-orchestration/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/oz-child-agent-orchestration

## What it does

oz-child-agent-orchestration manages work inside a child run: it sends the lead agent progress, completion, or blocker messages and returns concrete results for the lead to apply. The run is treated as an isolated remote environment, so unsynced local files, branches, terminals, and credentials are not assumed to be available.

The skill relies on Oz CLI plus `OZ_CLI`, `OZ_RUN_ID`, and `OZ_PARENT_RUN_ID`. It sends a milestone message, polls the inbox, and reads new instructions before continuing or stopping. Missing any of these variables blocks coordination with the parent run.

The skill is invoked only when the Oz harness system prompt asks the child agent to coordinate with a lead run. Installation places `SKILL.md` in the selected platform’s skill directory.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-child-agent-orchestration -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/oz-child-agent-orchestration/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/oz-child-agent-orchestration/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-child-agent-orchestration -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/oz-child-agent-orchestration/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-child-agent-orchestration -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/oz-child-agent-orchestration/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dominikmartn/harp resources/bundled/harness_skills/oz-child-agent-orchestration
```

2. **Manually: put the files in place**
- File: `.github/skills/oz-child-agent-orchestration/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-child-agent-orchestration -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/harness_skills/oz-child-agent-orchestration
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/oz-child-agent-orchestration/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dominikmartn/harp/tree/HEAD/resources/bundled/harness_skills/oz-child-agent-orchestration/SKILL.md

## When to use it
- hand a child run a subtask and its result
- send start, completion, or blocker updates to the lead
- poll for messages after sending an update
- resume work from the lead run’s latest instruction

## Example prompts
- Run this task as a child agent and send the lead agent a start update.
- Send the lead agent the result, changed paths, and validation commands through Oz CLI.
- Check the inbox for new instructions, then continue from the latest lead message.

## Similar
- [ai-team-orchestration](https://affpapa.org/en/nevibecode/skills/ai-team-orchestration.md) — skill · 381 installs
- [agent-orchestration-context-manager](https://affpapa.org/en/nevibecode/agents/agent-orchestration-context-manager.md) — subagent · ★ 42780 repo stars
- [hyva-child-theme](https://affpapa.org/en/nevibecode/skills/hyva-child-theme.md) — skill · 1400 installs
- [as-child](https://affpapa.org/en/nevibecode/rules/as-child.md) — rule · ★ 141 repo stars
- [orchestration](https://affpapa.org/en/nevibecode/skills/orchestration.md) — skill · 359600 installs
- [deep-agents-orchestration](https://affpapa.org/en/nevibecode/skills/deep-agents-orchestration.md) — skill · 17100 installs

From the same set: [dominikmartn/harp](https://affpapa.org/en/nevibecode/by/dominikmartn/harp.md) — 62 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
