Skip to main content
skill CX Codex

image-compare — Claude Code skill: image comparison

The image-compare Claude Code skill compares images and marks visual differences. It runs for design-to-screenshot checks and visual regression reviews.

no license 102 installs ★ 102 updated 2026-09-11

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add pascalorg/skills --skill image-compare -a claude-code
Open on GitHub

What image-compare does

The skill checks two images pixel by pixel and creates a diff image with changed areas marked in red. Its report includes the differing-pixel count, the mismatch share, and the dimensions used for the comparison.

The script relies on pixelmatch and scales differently sized images to their smaller shared dimensions. The output path and sensitivity threshold accept custom arguments; defaults are ./diff.png and 0.1.

What it helps with

  • compare a page screenshot with its design
  • find visual changes between two interface versions
  • check whether a UI matches a Figma export
  • create an image that marks visual differences

Example prompts for the agent

  • Compare design.png with screenshot.png and show me the visual differences.
  • Check what changed between before.png and after.png, saving the diff to ./changes.png.
  • Compare these two page screenshots and report the share of pixels that differ.

How to install image-compare

1Skills CLI (Vercel)

npx skills add pascalorg/skills --skill image-compare -a claude-code

2Manually: put the files in place

~/.claude/skills/image-compare/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/image-compare/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about image-compare

How do I install image-compare in Claude Code?

Run npx skills add pascalorg/skills --skill image-compare -a claude-code. The skill file is located at ~/.claude/skills/image-compare/SKILL.md.

What does image-compare do?

It compares two images at the pixel level, reports mismatch statistics, and creates a diff image with changed areas marked in red.

What happens when the images have different dimensions?

The script scales both to the smaller shared dimensions, then compares them at that size.

Similar skills

All skills for Design →

From the same set4

Project sponsors

Companies that keep this analytics open