mcpField
P
preview-shots

preview-shots

github.com/dzhngProductivity1.4k260 installsUpdated today
Repository

About preview-shots

preview-shots is an agent skill that presents selected review images together in macOS Preview. It curates and orders PNG or GIF artifacts, then labels each shot so reviewers can compare the relevant results in one window.

Key features

  1. 01Select only review-relevant images
  2. 02Open images together in Preview
  3. 03Order shots by importance
  4. 04Label each image for review
  5. 05Close windows when moving on

Use cases

  1. 01Reviewing recently changed screenshots
  2. 02Comparing an integrated result with a reference
  3. 03Presenting saved visual artifacts for feedback

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dzhng/skills --skill preview-shots

After installing, type/preview-shotsin Claude Code to confirm it loaded.

Details

From the project README

Preview Shots

Put the review-worthy images in front of the user in a single Preview window they can flip through.

Workflow

  1. Curate the set — the images that answer "is this right?": the just-changed or just-blessed baselines, the integrated result, and the reference image when there's something to compare against. Don't dump every PNG in the folder; pick the smallest set that lets the user judge the change. If the user named specific shots, open exactly those.
  2. One window — open them with a single open -a Preview <path> <path> ... call. One open invocation lands all the files in one window with a thumbnail sidebar; separate calls spawn separate windows.
  3. Caption them — list one line per shot (what it is) so the user knows what they're flipping through.

Rules

  • macOS only (open); pass absolute or repo-root-relative paths.
  • Order the files most-important-first; the first one is what Preview shows on open.
  • Review saved PNG/GIF artifacts, not live Chrome. Exact regression capture should run headless by default; only open Chrome when the user explicitly asks for a live browser or when reproducing a headful-only bug.
  • One set at a time — never pile up windows. Before opening a new set, close any open ones: osascript -e 'tell application "Preview" to close every window'.
  • Close on unattended proceed. When you opened shots for a non-blocking review and then move on without the user's response, close Preview afterward: osascript -e 'quit app "Preview"'. An overnight autonomous run must never wake the user to a wall of Preview windows — at most one set open, and none once you've proceeded past the checkpoint.

Comments

Markdown supported