Research: plannotator-annotate
Cached research evidence for plannotator-annotate (not authority).
Purpose
Section titled “Purpose”Plannotator-annotate launches the external Plannotator browser UI to annotate a markdown file, converted HTML, URL, or folder. The skill runs plannotator annotate <path-or-url>, waits for the annotation session, and feeds returned structured annotations back into the conversation for follow-up work. It is designed for cases where visual plan or document review benefits from a dedicated surface rather than inline chat.
Harness Coverage
Section titled “Harness Coverage”Target agents: antigravity, claude-code, codex, crush, cursor, gemini-cli, github-copilot, grok, opencode. The skill sets disable-model-invocation: true and delegates entirely to the plannotator CLI plus browser UI; the agent does not perform the annotation itself.
Trust And Risks
Section titled “Trust And Risks”Curated status install-now-after-trust-gate; trust_tier curated-trust-gated. The wrapper is minimal and shells out to a separately installed plannotator binary (MIT, open source at backnotprop/plannotator). Primary risks are execution of the external CLI, browser-launched local UI that can read local paths or URLs provided by the user, and optional encrypted sharing features. The project is actively developed with public demos and integrations for multiple agents; local execution keeps plans on-machine by default. Audit the installed binary and any companion hooks (e.g. grok-plannotator-hooks.json) before broad deployment.
Install Prerequisites
Section titled “Install Prerequisites”- Install the Plannotator CLI:
curl -fsSL https://plannotator.ai/install.sh \| bash(oruv run wagents grok plannotator install). npx skills add backnotprop/plannotator/apps/skills/core --skill plannotator-annotate -y -g -a antigravity claude-code codex crush cursor gemini-cli github-copilot grok opencode
Works alongside the review and last skills; Grok integration uses repo-synced hooks.
Upstream Maintainer
Section titled “Upstream Maintainer”backnotprop (https://github.com/backnotprop/plannotator). Official site: https://plannotator.ai/
Comparable Alternatives
Section titled “Comparable Alternatives”Inline plan/code review inside the primary agent chat; GitHub awesome-copilot excalidraw-diagram-generator or other visual diagramming skills for architecture sketches; dedicated PR review tools for code changes.
> Evidence gathered from public GitHub sources, raw SKILL.md, and project site (plannotator.ai). Not an endorsement or authority; inspect the CLI binary, hooks, and network behavior before use.
