SKILL.md
plannotator-tui: hand a document to the human for review
Only when HERDR_ENV=1 (you are running inside Herdr). Otherwise tell the human where the file is and ask them to review it.
- Write the document to a file. Do not paste it into chat as well.
- Open it for review, from your own pane:
``bash plannotator-tui herdr open docs/plans/auth.md ``
plannotator-tui opens beside you (or wherever the user configured it), already knowing that feedback comes back to this pane.
- End your turn. Do not wait, poll, or read the pane. The review arrives as the next
user message, as numbered feedback:
`` ## 1. (line 12) Feedback on: "Rotate the token on every…" > Rotation on every privilege change will log people out… ``
Address every item, then continue.
When you list files you want the human to open, print them as file:// hyperlinks (OSC 8) so Ctrl-click in Herdr opens them in plannotator-tui:
printf '\e]8;;file://%s\e\\%s\e]8;;\e\\\n' "$PWD/docs/plans/auth.md" "docs/plans/auth.md"If plannotator-tui is not on PATH, the raw Herdr command is:
herdr plugin pane open --plugin plannotator-tui --entrypoint doc --placement split \
--direction right --target-pane "$HERDR_PANE_ID" --focus --cwd "$PWD" \
--env PLANNOTATOR_TUI_FILE="$PWD/docs/plans/auth.md" --env PLANNOTATOR_TUI_DELIVER_TO="$HERDR_PANE_ID"