Give AI Feedback with Annotated Screenshots
The fastest, clearest way to fix a UI bug or polish a layout: draw on a screenshot, paste it in, tell the AI what to change.
In this chapter
- Why a marked-up image beats a long written description
- Which free tools to use on Mac, Windows, and the web
- How to paste an annotated screenshot into Cursor or Claude Code
- A prompt template that turns annotations into perfect fixes
Why a Marked-Up Screenshot Works So Well
Try describing this in words: "The button on the right of the navbar should be slightly bigger, with more padding on the sides, and the gap between it and the logo feels too tight."
Now imagine the same thing as a screenshot with a red circle around the button, an arrow pointing at the gap, and the words "make this bigger" and "more space here" scribbled on top.
The image version takes 30 seconds to make and the AI gets it on the first try. Modern AI coding tools (Claude Code, Cursor, Lovable, v0, Bolt) all understand images, so use that to your advantage.
The 3-Step Workflow
Once you do this twice it becomes muscle memory.
Software You Can Use
You probably already have one of these installed.
Best for: Quickest option on a Mac, no install needed
Best for: Quickest option on Windows, no install needed
Best for: Power users who annotate every day
What to Draw on Your Screenshot
Four marks cover 90% of the feedback you'll ever give.
Real World Example: Crowded mobile hero
Your hero section looks crowded on mobile. The headline overlaps the image and the button is jammed against the edge of the screen. You take a screenshot, draw red circles around the three issues, and paste it into Cursor with this prompt.
“Here's a screenshot of my homepage on mobile with notes on top. Please fix the three issues circled in red: 1. The headline is overlapping the image. Add more space between them. 2. The CTA button is touching the right edge. Add 16px horizontal padding to the section. 3. The image is too tall. Cap it at 60vh on screens under 768px wide. Keep all other styling the same.”
Prompt This
Paste your annotated screenshot, then send this prompt with it.
The Template
Here's a screenshot of [which page/section] with my notes drawn on top.
Please make the following changes:
1. [what the first red mark means]
2. [what the second red mark means]
3. [what the third red mark means]
Don't change anything that isn't marked. Keep the rest of the design exactly as it is.
Do This, Not That
Small habits that make the AI understand you on the first try.
Do
- Crop tightly to the area you want changed
- Use bright red marks on a normal-color screenshot (contrast helps)
- Number your changes (1, 2, 3) and reference the numbers in your prompt
- Tell the AI what NOT to change (it protects the rest of your design)
- Include the viewport size if it's a responsive bug ("mobile, 375px wide")
Don't
- Send a screenshot of your entire desktop (too much noise)
- Cover the element you want changed with your annotation
- Write a paragraph of notes on the image (keep marks short)
- Forget to attach the image and only describe in words
- Mix "this is broken" feedback with "build a new feature" (split them)
Frequently Asked Questions
Can I paste a screenshot directly into Claude Code or Cursor?
Yes. Both tools accept pasted images. Take your screenshot, copy it to the clipboard, then paste with Cmd+V (Mac) or Ctrl+V (Windows) directly into the chat. The AI can see arrows, circles, and text you draw on top.
What's the best free tool for annotating screenshots?
On Mac, the built-in Screenshot tool (Cmd+Shift+5) lets you mark up screenshots before saving. On Windows, the Snipping Tool does the same. For more features, CleanShot X is the favorite among designers and developers.
Do I need to be precise with my arrows and circles?
No. The AI just needs to know which area you're talking about. A rough circle around a button or a wobbly arrow pointing at a margin is enough. Your written note explains what to do.