---
name: dmmulroy-plannotator-tui
description: "Open a Markdown plan or document for the human to review and annotate in a Herdr pane; their feedback arrives as your next message. Use when you have written a plan, spec, or design document that needs human review before you act on it."
metadata:
  decimalai-skill-id: "d6849f2f-61d3-4cac-baf3-d110b748a56d"
  decimalai-version-id: "7ffd9668-e02a-45ab-9fe8-248c11cc52cb"
  decimalai-version: "1"
  decimalai-body-sha256: "3110a560f99c8f2ea00c70695453e99c2919bc619ad289fca8b6d70322312653"
  decimalai-name: "dmmulroy/plannotator-tui"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "agent-tooling"
  decimalai-source: "https://app.decimal.ai/s/dmmulroy-plannotator-tui@1/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.

1. Write the document to a file. Do not paste it into chat as well.
2. 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.
3. **End your turn.** Do not wait, poll, or read the pane. The review arrives as the next
   user message, as numbered feedback:

   ```text
   ## 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:

```bash
printf '\e]8;;file://%s\e\\%s\e]8;;\e\\\n' "$PWD/docs/plans/auth.md" "docs/plans/auth.md"
```