visual-verdict

Compare generated UI screenshots against reference images and return a strict JSON verdict.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/hotaq/Sprite_harmess --skill visual-verdict-hotaq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: visual-verdict
Source: https://github.com/hotaq/Sprite_harmess/tree/main/.codex/skills/visual-verdict
Command: npx skills add https://github.com/hotaq/Sprite_harmess --skill visual-verdict-hotaq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns screenshot comparison into a deterministic visual QA decision, so you can quickly tell whether a generated UI matches its reference.

Core Features & Use Cases

  • Strict verdict output: Produces a JSON-only pass, revise, or fail result for screenshot-to-reference checks.
  • Visual mismatch diagnosis: Identifies differences in layout, spacing, typography, color, and hierarchy.
  • Iterative editing loop: Helps teams refine generated interfaces until they reach a high-confidence match.
  • Use case: Compare a newly rendered dashboard against a design mockup and get concrete next-step edits when the output still diverges.

Quick Start

Ask the skill to compare your generated screenshot against the provided reference image set and return a strict JSON verdict with actionable differences.

Frequently Asked Questions about visual-verdict

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

FAQPage Schema
How do I run visual regression testing for a generated UI screenshot?▼

Visual regression testing for a generated UI screenshot compares it against reference images to return a strict JSON verdict. It identifies layout, spacing, and typography differences to determine if the output passes, needs revision, or fails.

What is screenshot comparison for design fidelity?▼

Screenshot comparison for design fidelity is a visual QA process that checks a rendered UI against a mockup. It validates pixel-level differences in hierarchy and color, returning a strict score and actionable suggestions to refine the interface.

How do I identify pixel diff mismatches in my UI layout?▼

To identify pixel diff mismatches, compare your generated screenshot against a set of reference images. The visual QA process diagnoses specific differences in spacing, typography, and hierarchy, returning concrete next-step edits.

Can I use screenshot comparison for iterative design edits?▼

Yes, you can use screenshot comparison for iterative design edits by repeatedly checking a generated UI against a reference. It provides a high-confidence match score and revision suggestions until the layout strictly passes visual QA.

What do I need to perform visual QA on a UI screenshot?▼

To perform visual QA, you need one or more reference images and a generated UI screenshot. The process requires no external dependencies, directly comparing the inputs to output a pass, revise, or fail decision with reasoning.