About plannotator-review
A Plannotator skill for reviewing code changes in a browser-based session, with options to scope reviews to a branch layer or another repository.
Key features
- 01Review code changes in Plannotator
- 02Set a Git base and diff type
- 03Target another directory or PR URL
- 04Handle review feedback or approval
Use cases
- 01Review one layer of a stacked branch
- 02Review changes in another worktree
- 03Apply returned annotations to code
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ backnotprop/ plannotator --skill plannotator-reviewAfter installing, type/plannotator-reviewin Claude Code to confirm it loaded.
Bundled filesagents/openai.yaml
Details
From the project READMEPlannotator Review
Use this skill when the user wants to review current code changes in Plannotator instead of reading a diff inline.
Run:
plannotator review [--base <ref>] [--diff-type <type>] [directory-or-pr-url]
Reviewing one layer of a stacked branch? Pass --base <the branch immediately below yours> so the review shows only what this layer adds, instead of everything since main. Both flags are session-only (the reviewer can change either in the UI; nothing is persisted) and git-only.
To review another repository or worktree, pass its directory (relative to the current session or absolute), e.g. plannotator review ../feature-worktree. Quote paths containing spaces. Feedback names the selected directory; apply changes there.
Behavior:
- Launch the command with Bash.
- Wait for it to finish.
- If it returns feedback or annotations, address them in the same conversation.
- If it returns an approval/LGTM-style message, acknowledge that review passed and continue.
- If the session closes without feedback (the output is "Review session closed without feedback." or empty), acknowledge it in one sentence and stop. Do not begin any work: closing the session is not approval.
Do not ask the user to copy shell commands into chat. Run the command yourself.