---
name: Plannotator Annotate
slug: plannotator-annotate-2
category: Quality
description: "Plannotator Annotate opens Plannotator's annotation UI for a markdown file, HTML file, URL, or folder, then responds to the returned annotations. Use it when an agent needs human review of content before proceeding or to collect feedback."
github: "https://github.com/backnotprop/plannotator/tree/main/apps/skills/claude/plannotator-annotate"
language: TypeScript
stars: 7797
forks: 572
install: "npx degit https://github.com/backnotprop/plannotator/tree/main/apps/skills/claude/plannotator-annotate ~/.claude/skills/plannotator-annotate"
installs_to: ~/.claude/skills/plannotator-annotate
source_path: apps/skills/claude/plannotator-annotate/SKILL.md
collection_size: 15
category_size: 1354
collection_url: "https://dirskills.com/collections/backnotprop/plannotator"
added: 2026-08-15T06:51:17.180Z
last_synced: 2026-08-15T06:51:17.180Z
canonical_url: "https://dirskills.com/skills/plannotator-annotate-2"
---

# Plannotator Annotate

Plannotator Annotate opens Plannotator's annotation UI for a markdown file, HTML file, URL, or folder, then responds to the returned annotations. Use it when an agent needs human review of content before proceeding or to collect feedback.

**Install:**

```bash
npx degit https://github.com/backnotprop/plannotator/tree/main/apps/skills/claude/plannotator-annotate ~/.claude/skills/plannotator-annotate
```

## README

# Plannotator Annotate

## Markdown annotations

!`plannotator annotate $ARGUMENTS`

## Your task

The output above will be one of:

1. The exact text `The user approved.`, OR a JSON object with `"decision": "approved"`. The user approved the markdown file(s). If that object also carries a `"feedback"` field, the user approved *with notes*: read them and carry them into subsequent work — they are non-blocking guidance, not a request to revise the file. Otherwise acknowledge with a single sentence ("Approved.") and stop. Either way, do not begin any work.
2. Empty, OR a JSON object with `"decision": "dismissed"`. The user closed the session without requesting changes. Acknowledge with a single sentence ("Annotation session closed.") and stop. Do not begin any work.
3. Plaintext annotation feedback, OR a JSON object with `"decision": "annotated"` and a `"feedback"` field. Address the feedback. The user has reviewed the markdown file(s) and provided specific annotations and comments.
4. A message that the arguments could not be resolved to a file, URL, or folder. The user described what to annotate in natural language: work out which file, URL, or folder they mean, run `plannotator annotate <path-or-url>` yourself with that concrete target (keeping any flags the message echoes), then handle its output per cases 1-3.