Skip to content
cccskills
FreePublished on GitHub

plannotator-annotate

Collect comments on a Markdown or HTML document, plain-text configuration file, URL, or folder through Plannotator’s annotation interface. Use the returned notes to revise the material; with gated review, a plan or specification can also receive an approval decision.

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.

backnotprop/plannotator9,756 stars(GitHub 9,756 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Gathering feedback on a Markdown document
  • Reviewing a configuration file or folder
  • Collecting notes on a URL
  • Requesting approval for a plan or specification

Files included (1)

  • SKILL.md2.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Plannotator Annotate (Qwen Code)

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

Run it with the shell tool's is_background: true, and no trailing &. The command waits until the person finishes in the browser, which often takes longer than the shell tool's foreground limit (2 minutes by default, 10 at most); a foreground run would be stopped and the annotations lost. Then end your turn without stopping the task. When the task finishes, read its output (the tool result names the output file) and act on it.

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. If annotations are returned, address them directly.
  2. If the session closes without feedback (the output is empty, or a JSON object with "decision": "dismissed"), acknowledge it in one sentence and stop. Do not begin any work: closing the session is not approval.
  3. 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.
  4. 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.8KUpdated Oct 30, 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.8KUpdated Oct 30, 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.8KUpdated Oct 30, 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.8KUpdated Oct 30, 2026

Open the Plannotator Inbox in a browser, starting it in the background if needed, and give the user its address. Useful when they have closed the tab or need to find the Inbox again.

  • Reopen a closed Plannotator Inbox tab
  • Find the address of the Plannotator Inbox
  • Open the Inbox when its service is not running
backnotprop/plannotator9.8KUpdated Oct 30, 2026

Open the Plannotator Inbox in a browser, starting it in the background if needed, and give the user its address. Useful when they have closed the tab or need to find the Inbox again.

  • Reopen a closed Plannotator Inbox tab
  • Find the address of the Plannotator Inbox
  • Open the Inbox when its service is not running
backnotprop/plannotator9.8KUpdated Oct 30, 2026

See all skills by backnotprop

Report a problem with this skill