vrt-visual-diff

Compare two rendered pages and generate a structured Markdown visual diff report.

22|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/mizchi/vlmkit --skill vrt-visual-diff-mizchi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vrt-visual-diff
Source: https://github.com/mizchi/vlmkit/tree/main/.apm/skills/vlmkit/workflows/vrt-visual-diff
Command: npx skills add https://github.com/mizchi/vlmkit --skill vrt-visual-diff-mizchi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright.

What problem does it solve? After editing CSS, HTML, or a component, it is hard to know exactly what visibly changed, where it changed, and which CSS properties caused it. This Skill compares two rendered pages (URL pairs or local HTML files) and produces a single Markdown report that a coding agent can read in one context window. ## Core Features & Use Cases - Pixel and computed-style diffing: Runs vlmkit diff html for Playwright-driven capture, pixel diff per viewport, and computed-style comparison split into universal vs. breakpoint-gated property changes. - Agent-readable Markdown report: Runs vlmkit diff agent to format the JSON report with per-viewport diffRatio, per-section component heatmaps, heuristic fix candidates, and worst-viewport screenshot paths. - Regression detection: Surfaces a warning banner when a majority of viewports got worse compared to a prior run's persisted summary. - Use Case: After refactoring a stylesheet, run the diff on the before and after HTML files to confirm whether the change is a visual no-op or to get a selector-level list of property: a → b fixes. ## Quick Start Ask the agent to run vlmkit diff html on before.html and after.html with an output directory, then run vlmkit diff agent on the resulting diff-report.json to get the Markdown summary.

Frequently Asked Questions about vrt-visual-diff

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

FAQPage Schema
How do I check what visually changed after a CSS edit?

Run vlmkit diff html on the before and after HTML files or URLs, then run vlmkit diff agent on the generated diff-report.json. The Markdown report lists per-viewport pixel diff percentages and computed-style property changes by selector.

How to compare two URLs for visual differences with Playwright?

Pass --url and --current-url to vlmkit diff html to capture both pages in headless Chromium across multiple viewports. The tool writes diff PNGs and a JSON report that vlmkit diff agent formats into a readable summary.

Why does my visual diff show changes on an unmodified page?

Animations, clocks, marquees, and hash-randomized classes flap between runs and appear as diffs. Pass --mask with a quoted comma-separated CSS selector list to exclude non-deterministic regions from the comparison.

Does visual diffing require an API key or LLM?

No. The pixel diff and computed-style comparison path is fully deterministic and requires no environment variables, VLM, or LLM. Only Playwright with Chromium installed is needed.

When should I not use a one-shot visual diff?

Avoid it for scheduled monitoring with no prior diff, screenshot-to-component synthesis, or automated CSS repair loops. Those scenarios are handled by the vrt-regression-watch, vrt-markup-synth, and vrt-css-fix-loop workflows respectively.