skills/use-cli-herdr/SKILL.md
Delegate implementation to codex (coder) via the herdr-agentchat plugin and drive a two-pane conversation to completion.
npx skillsauth add thkt/claude-config use-cli-herdrInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Run inside a herdr pane (HERDR_ENV=1) with the thkt.agentchat plugin installed. The send script lives at ~/.config/herdr/plugins/github/thkt.agentchat-*/actions/send.sh (the glob resolves uniquely). Do not use codex exec or launch codex directly. That leaves the conversation and completion-relay machinery, so reports stop arriving.
herdr agent rename "$HERDR_PANE_ID" leaderherdr plugin action invoke thkt.agentchat.start-coder (codex starts in a right split in no-approval mode; check results with herdr plugin log list --plugin thkt.agentchat)herdr agent read coder --source visible shows Press t to trust, run herdr agent send-keys coder t; when it shows Press enter to view hooks, run herdr agent send-keys coder esc. A body sent while a dialog is showing gets swallowed, so confirm a bare input prompt before Phase 2bash ~/.config/herdr/plugins/github/thkt.agentchat-*/actions/send.sh --reply-to leader coder "<instruction>"
Include target files, completion criteria, and write-scope constraints in the instruction. --reply-to leader embeds the reply command for coder into the body automatically.
| exit | Meaning | Response |
| ---- | ------------------------------------------------------- | ------------------------------------------------------------- |
| 0 | coder started | Wait for the report |
| 3 | Identical resend | Do not resend |
| 5 | coder is blocked | Awaiting human approval. Do not send |
| 6 | Wake failed (body may sit unsubmitted in its input box) | Do not resend; check the screen with herdr agent read coder |
| 7 | Start not observed (delivered if already working) | Check state with herdr agent get coder. Do not resend |
Coder's turn completion arrives automatically as an [auto-relay] message. No polling is needed; continue your own work until it arrives. When coder's own send report and the auto-relay both arrive, prefer the send report. Blocked transitions are toast-notified to the human, so the leader does not stand in for approvals. After receipt, verify (run tests, check the diff) before the next instruction or the report to the human.
development
Extract recurring patterns from past closed PRs/issues and the research findings in workspace/research/, verify them against the latest code, and propose them to docs/wiki/ via PR.
development
Create Decision Records (DR) in MADR v4 format with auto-numbering.
development
Codex review + cleanup. Findings are challenged by critic-audit, not aggregated as facts, and fixes are applied directly. Do NOT use for internal multi-reviewer deep audits or findings reports (use /audit).
development
Detect flaky tests by shaking them — repeated runs under varied order, parallelism, and seed — plus a static smell scan that flags latent flakiness in tests that currently pass. Classify each target as confirmed-flaky, latent-flaky, or stable and fix the root cause without weakening the test. Do NOT use to fix a confirmed single bug (use /fix) or for static-only code review (use /audit).