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
npx skills add pascalorg/skills --skill image-compare -a claude-codeWhat 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.pngwithscreenshot.pngand show me the visual differences. - Check what changed between
before.pngandafter.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-code2Manually: put the files in place
~/.claude/skills/image-compare/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/image-compare/
1Skills CLI (Vercel)
npx skills add pascalorg/skills --skill image-compare -a codex2Manually: put the files in place
.agents/skills/image-compare/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pascalorg/skills --skill image-compare -a cursor2Manually: put the files in place
.cursor/skills/image-compare/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pascalorg/skills image-compare2Manually: put the files in place
.github/skills/image-compare/SKILL.md1Skills CLI (Vercel)
npx skills add pascalorg/skills --skill image-compare -a gemini-cli2Platform CLI
gemini skills install https://github.com/pascalorg/skills --path image-compareManually: put the files in place
.devin/skills/image-compare/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pascalorg/skills --skill image-compare -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.