visual-compare

Compares reference and replica UI screenshots to generate gap reports and prioritized remediation steps.

1|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/JDerekLomas/claude-code-skills --skill visual-compare
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-compare
Source: https://github.com/JDerekLomas/claude-code-skills/tree/main/skills/visual-compare
Command: npx skills add https://github.com/JDerekLomas/claude-code-skills --skill visual-compare

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Visual comparison of a reference app against a replica build. Screenshots both via Chrome DevTools, uses Claude vision to identify differences, generates gap reports. Use when asked to compare, audit visuals, check replication fidelity, or run a visual diff.

Core Features & Use Cases

  • Full visual diff between reference and replica across routes
  • Generate structured gap reports with actionable items
  • File issues linked to ground-truth reference images and replica captures

Quick Start

Run a full visual comparison between a reference app and its replica, generate a gap report, and file issues for any visual discrepancies.

Frequently Asked Questions about visual-compare

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate visual comparison between a reference UI and a replica build?

Automating visual comparison involves capturing screenshots of both reference and replica interfaces, then using Claude Vision to identify visual discrepancies and generate structured gap reports with prioritized remediation steps.

Do I need Chrome DevTools to run a UI audit on deployed web apps?

Yes, running a UI audit requires Chrome DevTools MCP connectivity to capture screenshots of deployed URLs for both the reference application and the replica build across multiple states and viewport sizes.

What is a visual gap report and how does it help fix UI differences?

A visual gap report is a structured document detailing UI differences found via screenshot analysis, providing actionable items and prioritized remediation steps to fix visual fidelity issues between a reference and replica.

Can I check replication fidelity across multiple routes and viewport sizes?

Yes, you can check replication fidelity across multiple routes, states, and viewport sizes by capturing ground-truth reference screenshots and replica captures, then applying visual diff analysis to produce gap reports.

What directory structure is required for screenshot analysis during a visual diff?

Screenshot analysis requires a ground-truth screenshots directory located at docs/screenshots, alongside deployed URLs for both the reference and replica applications to facilitate accurate visual comparison.