annotate-screenshots
Installation
SKILL.md
Annotating screenshots
When to annotate
Add annotations when a screenshot needs to draw the reader's eye somewhere specific — a new element, a bug, a diff — rather than leaving them to find it in the caption. A plain before/after pair is often enough; reach for annotation when "look at the top-right corner" is easier to say with an arrow than with words, or when a screenshot contains a secret that must be hidden before it's shared anywhere (uploads.sh URLs are public).
Two commands, same underlying spec format:
| Command | Input | Targeting |
|---|---|---|
uploads screenshot <url|file.html> --annotate <spec> |
captures a live page | CSS selectors (preferred) or pixel coordinates |
uploads annotate <image> --spec <spec> |
an existing PNG/JPEG file | pixel coordinates only — selectors are rejected |