herdr-orchestration — Claude Code skill: what it does, how to install
herdr-orchestration controls interactive Claude and Codex worker TUIs in dedicated herdr tabs using socket CLI commands.
no license 210 installs ★ 655 updated 2026-10-20
npx skills add pedronauck/skills --skill herdr-orchestration -a claude-codeWhat herdr-orchestration does
The skill structures a controller agent to partition work across sub-agents. Each worker receives an isolated tab labeled with model and task slug. The primary agent keeps track of state via HERDR_WORKSPACE_ID, HERDR_TAB_ID, and HERDR_PANE_ID.
Workers require interactive TUI sessions rather than headless streams. Claude boots with --dangerously-skip-permissions while Codex takes --yolo, preventing stalls on confirmation dialogs. A running herdr daemon is mandatory; without it the socket CLI cannot detect agent readiness.
What it helps with
- dispatch slices of work across autonomous Claude and Codex workers
- manage labeled herdr tabs without stealing terminal focus
- submit followup prompts atomically with status wait locks
- prevent stalled runs caused by headless JSON streams
Example prompts for the agent
- Launch a Codex worker tab to review authentication routes
- Send a followup prompt to the refactoring worker and wait for completion
How to install herdr-orchestration
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill herdr-orchestration -a claude-code2Manually: put the files in place
~/.claude/skills/herdr-orchestration/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/herdr-orchestration/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill herdr-orchestration -a codex2Manually: put the files in place
.agents/skills/herdr-orchestration/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill herdr-orchestration -a cursor2Manually: put the files in place
.cursor/skills/herdr-orchestration/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/mine/herdr-orchestration2Manually: put the files in place
.github/skills/herdr-orchestration/SKILL.md1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill herdr-orchestration -a gemini-cli2Platform CLI
gemini skills install https://github.com/pedronauck/skills --path skills/mine/herdr-orchestrationManually: put the files in place
.devin/skills/herdr-orchestration/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pedronauck/skills --skill herdr-orchestration -a opencodeClaude.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 herdr-orchestration
How to install herdr-orchestration in Claude Code?
Run npx skills add pedronauck/skills --skill herdr-orchestration -a claude-code in your terminal.
What does herdr-orchestration do?
It guides an orchestration agent to spawn, monitor, and retire terminal-based worker sessions inside herdr tabs.
Why are headless runners unsupported?
Commands like claude -p pipe raw JSON instead of interactive screens, preventing herdr hooks from tracking when the agent turns idle.