plannotator-annotate

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

9|Updated Jul 17, 2026
One-click install
npx skills add https://github.com/Yassimba/loom --skill plannotator-annotate-yassimba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plannotator-annotate
Source: https://github.com/Yassimba/loom/tree/main/drafts/plannotator-annotate
Command: npx skills add https://github.com/Yassimba/loom --skill plannotator-annotate-yassimba

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires plannotator.

What problem does it solve? Reviewing long documents inline in chat is cumbersome, and collecting structured feedback on plans, configs, or web pages requires switching between tools. This Skill launches Plannotator's browser-based annotation UI so reviewers can mark up a document visually, then brings the returned annotations back into the conversation for action. ## Core Features & Use Cases - Browser-Based Annotation: Runs plannotator annotate <path-or-url> to open a markdown file, plain-text config file (.yaml, .json, .toml, .ini, .csv, .log), HTML file, URL, or folder in Plannotator's review UI. - Annotation Handling: Reads returned annotations and addresses them directly, including approval notes carried in a "decision": "approved" result with a "feedback" field. - Argument Recovery: If the command cannot resolve its arguments to a file, URL, or folder, the Skill infers the intended target and re-runs the command with a concrete path or URL. - Use Case: A user drafts an implementation plan in markdown and wants a teammate-style review. The Skill opens the plan in Plannotator, waits for the browser session to finish, then applies the reviewer's inline comments to the document. ## Quick Start Use the plannotator-annotate skill to open docs/plan.md in Plannotator and address the annotations that come back.

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 in Plannotator?

Run the command `plannotator annotate <path-or-url>` with the path to your markdown file. Plannotator opens a browser-based review UI, and once the session finishes, the returned annotations are addressed directly in the conversation.

What file types can Plannotator annotate?

Plannotator's annotate command accepts markdown files, plain-text config files such as .yaml, .json, .toml, .ini, .csv, and .log, HTML files, URLs, and entire folders. The target is passed as a single path or URL argument.

Can I annotate a URL or web page with Plannotator?

Yes, the annotate command accepts a URL in addition to local files and folders. Pass the URL as the argument, and Plannotator opens the page in its browser review UI for annotation.

What happens if a Plannotator review is approved with feedback?

An approval can still include notes in a `"decision": "approved"` result with a `"feedback"` field. Those notes are read and carried into subsequent work as guidance, but the document is not revised over them since they are not a change request.

Why does plannotator annotate fail to resolve my file path?

The command reports an error when its arguments cannot be resolved to a file, URL, or folder. When this happens, determine which target the user means and re-run the command with a concrete, valid path or URL.