Skip to content
cccskills
FreePublished on GitHub

plannotator-annotate

Open documents, text configuration files, HTML, URLs, or folders in Plannotator for browser review. The agent responds to returned annotations and can use an approval session when you need to accept a plan, specification, or document.

OriginalShow the original description

Open Plannotator's annotation UI for a markdown file, plain-text config file (.yaml, .json, .toml, .ini, .csv, .log, …), HTML file, URL, or folder and then respond to the returned annotations.

See how to install

Good for

  • Adding document feedback in a browser
  • Reviewing text configuration files or HTML
  • Approving a generated plan or specification
  • Reviewing content at a URL or in a folder

Files included (2)

  • SKILL.md1.7 KB
  • agents/openai.yaml173 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Plannotator Annotate

Use this skill when the user wants to annotate a document in Plannotator instead of reviewing it inline in chat.

Run for ordinary annotation/feedback:

plannotator annotate <path-or-url>

Run when the user asks to review, approve, accept, or gate a generated plan/spec/document:

plannotator annotate <path-or-url> --gate --json

Plain annotate has no Approve button; it only supports feedback or closing the session. Never promise an approval action unless --gate is present. --json only changes the output format and does not enable approval by itself.

Behavior:

  1. Launch the command with Bash.
  2. Wait for the browser review to finish.
  3. If annotations are returned, address them directly.
  4. If the session closes without feedback, say so briefly and continue.
  5. In a --gate session, an approval may still carry notes — a "decision": "approved" result with a "feedback" field (without --json, an "Approved with Notes" message). Read those notes and carry them into subsequent work, but do not revise the document over them: they are guidance, not a change request.
  6. If the command reports that the arguments could not be resolved to a file, URL, or folder, work out which target the user means and re-run the command yourself with that concrete path or URL.

Do not ask the user to paste a shell command into the chat. Run the command yourself.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

plannotator

FreeSummary

Use Plannotator to review plans, code changes, documents, and running local apps in a browser. This reference covers returning feedback to agents, browsing past decisions, sharing guided code reviews, and leaving questions for later replies.

  • Reviewing and approving plans or specifications
  • Reviewing local code changes or pull requests
  • Annotating documents or running local apps
backnotprop/plannotator9.5KUpdated Oct 19, 2026

Open files, folders, or URLs in Plannotator’s annotation interface, then have the agent address the returned comments. Use it to review Markdown, plain-text configuration files, or HTML through a shared feedback workflow.

  • Reviewing a Markdown document
  • Commenting on configuration files
  • Opening a folder for annotation
backnotprop/plannotator9.5KUpdated Oct 19, 2026

Review Markdown files, HTML files, URLs, or folders in Plannotator’s annotation interface. The agent responds to requested changes and distinguishes them from approvals, optional approval notes, and sessions closed without feedback.

  • Reviewing a Markdown document
  • Collecting comments on HTML or web pages
  • Opening a folder for annotation
backnotprop/plannotator9.5KUpdated Oct 19, 2026

Analyze rejected plans and reviewer feedback to identify recurring concerns, changing expectations, and concrete prompt improvements. Produce an HTML dashboard from Plannotator archives, or use Claude Code plan rejection reasons when those archives are unavailable.

  • Finding recurring reasons for plan rejection
  • Understanding how review expectations changed
  • Deriving planning instructions from past feedback
backnotprop/plannotator9.5KUpdated Oct 19, 2026

plannotator-last

FreeSummary

Open the assistant’s latest rendered message in Plannotator and return specific annotations for revision. The skill distinguishes requested edits from approval, approval with notes, and a closed session, so each review result receives the appropriate response.

  • Annotate the assistant’s latest response for revision
  • Approve a response without requesting further work
  • Approve with notes to guide subsequent work
backnotprop/plannotator9.5KUpdated Oct 19, 2026

Review code changes in Plannotator’s browser interface and have the agent address returned comments. Choose the current working directory, another checkout, or a pull or merge request URL, with options to focus on a specific comparison base.

  • Review changes in the current working directory
  • Review a separate working directory
  • Review a pull or merge request by URL
backnotprop/plannotator9.5KUpdated Oct 19, 2026

See all skills by backnotprop

Report a problem with this skill