plannotator-annotate

Opens Plannotator's annotation UI for markdown files, HTML files, URLs, or folders and processes returned feedback.

Updated Aug 20, 2026
One-click install
npx skills add https://github.com/bittlinkm/claude-setup --skill plannotator-annotate-bittlinkm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plannotator-annotate
Source: https://github.com/bittlinkm/claude-setup/tree/main/skills/plannotator-annotate
Command: npx skills add https://github.com/bittlinkm/claude-setup --skill plannotator-annotate-bittlinkm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing markdown documents, plans, or web pages often requires back-and-forth feedback that is hard to capture in plain chat. This Skill opens an interactive annotation UI so users can mark up files directly and returns structured decisions (approved, dismissed, or annotated) for the AI to act on. ## Core Features & Use Cases - Interactive Annotation UI: Launches Plannotator against a markdown file, HTML file, URL, or folder via the plannotator annotate command. - Structured Decision Handling: Interprets JSON or plaintext outcomes—approved (with optional non-blocking feedback), dismissed, or annotated—and responds appropriately. - Natural Language Target Resolution: When arguments cannot be resolved to a file, URL, or folder, it infers the intended target and reruns the command with a concrete path. - Use Case: After drafting an implementation plan in markdown, run this Skill so the user can visually annotate the plan; the AI then addresses each comment or proceeds once approved. ## Quick Start Ask the AI to open the annotation UI for your plan document, for example by saying: annotate my plan.md file with Plannotator.

Frequently Asked Questions about plannotator-annotate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I annotate a markdown file with Plannotator?

Run the plannotator annotate command with the path to your markdown file, or invoke this Skill with the file as an argument. The annotation UI opens, and the returned output indicates whether the file was approved, dismissed, or annotated with feedback.

What file types can Plannotator annotate?

Plannotator's annotation UI accepts markdown files, HTML files, URLs, and folders. You pass the target as an argument to the plannotator annotate command, and the Skill handles the returned decision output.

What happens after a document is approved in Plannotator?

When the output is an approval, the Skill acknowledges it and stops without beginning any work. If the approval includes a feedback field, those notes are treated as non-blocking guidance carried into subsequent work.

What if Plannotator cannot resolve my annotation target?

If the arguments cannot be resolved to a file, URL, or folder, the Skill interprets the natural language description, determines the intended target, and reruns plannotator annotate with the concrete path or URL while preserving any flags.

Can I use Plannotator to review web pages?

Yes, the annotation UI accepts URLs in addition to local files and folders. Pass the URL to the plannotator annotate command and the returned annotations are handled the same way as file-based feedback.