visual-verdict

Compare UI screenshots against reference images and output JSON visual QA verdicts.

2|Updated May 11, 2026
One-click install
npx skills add https://github.com/xz1220/oh-my-kimi --skill visual-verdict-xz1220
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-verdict
Source: https://github.com/xz1220/oh-my-kimi/tree/main/skills/visual-verdict
Command: npx skills add https://github.com/xz1220/oh-my-kimi --skill visual-verdict-xz1220

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of uncertain, subjective visual review by comparing a generated UI screenshot against one or more reference images and producing deterministic pass/fail guidance.

Core Features & Use Cases

  • Structured Visual QA Judgment: Produces a strictly formatted JSON verdict (score, verdict, differences, suggestions, and reasoning) for iterative editing loops.
  • Category-Aware Matching: Flags whether the generated UI matches the expected visual category/style using category_match.
  • Actionable Remediation: Converts visual mismatches (layout, spacing, typography, color, hierarchy) into concrete next-step edits.

Use case example: Validate a generated dashboard screen against reference designs; if the score is below 90, drive the next edit cycle with targeted difference descriptions (e.g., spacing/typography shifts) until the UI passes.

Quick Start

Provide your generated UI screenshot and the reference images, then ask the skill to return a strict JSON verdict with differences and edit suggestions.

Frequently Asked Questions about visual-verdict

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

FAQPage Schema
How do I automate visual regression testing for generated UI screenshots against reference images?

Visual regression testing for generated UI screenshots is automated by comparing them against reference images to produce a structured JSON verdict. This includes a 0-100 score, pass/revise/fail outcome, category matching, explicit differences, and actionable edit suggestions.

What is a JSON verdict in UI QA and how does it guide iterative design refinement?

A JSON verdict in UI QA is a strictly formatted output that scores visual fidelity from 0-100 and flags layout, spacing, typography, color, and hierarchy mismatches. It guides iterative design refinement by providing concrete next-step edits to reach a 90+ threshold.

How do I validate dashboard layout fidelity and component styling against design references?

You validate dashboard layout fidelity and component styling by providing your generated UI screenshot and reference images for comparison. The evaluation checks category matching and returns explicit visual differences with actionable remediation steps to correct deviations.

Can I use screenshot comparison for component-level styling verification without external dependencies?

Yes, you can use screenshot comparison for component-level styling verification without external dependencies. The evaluation logic processes the provided UI screenshots and reference images internally to determine structured visual pass/fail outcomes.

What should I do when my UI typography and spacing differences keep failing visual validation?

When UI typography and spacing differences keep failing visual validation, use the actionable remediation output from the JSON verdict. It converts specific visual mismatches into concrete next-step edits, driving the next iteration loop until the score reaches 90+.

Does visual pass/fail validation work for iterative UI reproduction tasks like feed pages?

Visual pass/fail validation works effectively for iterative UI reproduction tasks such as feed pages and dashboards. It evaluates layout fidelity, flags category matching status, and outputs targeted difference descriptions to drive subsequent editing cycles.