visual-regression-testing

name	visual-regression-testing
description	Use when UI changes require repo-defined snapshot or visual-diff verification, baseline review, or a UI Visual Verification Report.
metadata	{"short-description":"Tool-agnostic UI visual verification contract","requires":["references/visual-regression-testing.md"],"resources":["references/visual-regression-android.md","references/visual-regression-ios.md","references/visual-regression-web.md"]}

Purpose

Use this skill to enforce a consistent UI visual verification contract without hard-coding a specific test framework.

When to use

• Any UI code changed (iOS/SwiftUI, Android/Compose/XML, web UI/components/styles).
• The request mentions pixel perfect, UI matches design, snapshot, or screenshot.

How to use

1. Open references/visual-regression-testing.md.
2. Also open the matching platform reference: references/visual-regression-android.md for Android targets, references/visual-regression-ios.md for iOS targets, references/visual-regression-web.md for web targets.
3. Discover the live UI verify/record interface from repo commands, CI config, tool help, and snapshot config before trusting examples.
4. Review produced artifacts and compare against baselines/design mocks.
5. Update baselines only for intentional UI changes.
6. Output the required report format exactly.

Gotchas

• Common pitfall: skipping snapshot verification even though UI changed. Instead: run the repo-defined UI verification command and always check whether diffs exist.
• recording failed snapshots in bulk without root-cause review. review diff images and apply only intended changes to baseline.