oz-child-agent-orchestration — Claude Code skill: install
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.
AGPL-3.0 ★ 720 updated 2026-11-10
npx skills add dominikmartn/harp --skill oz-child-agent-orchestration -a claude-codeWhat oz-child-agent-orchestration 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.
What it helps with
- 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 for the agent
- 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.
How to install oz-child-agent-orchestration
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill oz-child-agent-orchestration -a claude-code2Manually: put the files in place
~/.claude/skills/oz-child-agent-orchestration/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/oz-child-agent-orchestration/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill oz-child-agent-orchestration -a codex2Manually: put the files in place
.agents/skills/oz-child-agent-orchestration/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill oz-child-agent-orchestration -a cursor2Manually: put the files in place
.cursor/skills/oz-child-agent-orchestration/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp resources/bundled/harness_skills/oz-child-agent-orchestration2Manually: put the files in place
.github/skills/oz-child-agent-orchestration/SKILL.md1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill oz-child-agent-orchestration -a gemini-cli2Platform CLI
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/harness_skills/oz-child-agent-orchestrationManually: put the files in place
.devin/skills/oz-child-agent-orchestration/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about oz-child-agent-orchestration
How do I install oz-child-agent-orchestration in Claude Code?
Run npx skills add dominikmartn/harp --skill oz-child-agent-orchestration -a claude-code, then check ~/.claude/skills/oz-child-agent-orchestration/SKILL.md.
What does oz-child-agent-orchestration do?
It gives a child agent a workflow for reporting progress, results, and blockers to a lead run through Oz CLI. The workflow also polls for incoming instructions.
What does oz-child-agent-orchestration require?
It requires Oz CLI and the OZ_CLI, OZ_RUN_ID, and OZ_PARENT_RUN_ID variables. The skill runs in a child Oz agent environment.