visual-verdict

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

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill visual-verdict-kyrie66nb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-verdict
Source: https://github.com/KYRIE66nb/codex-omx-public-config/tree/main/home/.codex/skills/visual-verdict
Command: npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill visual-verdict-kyrie66nb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a deterministic evaluation of UI screenshots by comparing a generated image to one or more reference images and returning a strict JSON verdict that can drive iterative design edits.

Core Features & Use Cases

  • Deterministic visual-diff based verdicts for UI QA
  • Category matching of UI style, layout, typography, and color differences
  • Use Case: A design or product team wants to automatically verify that a new screen matches the approved reference before release

Quick Start

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

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 verification for UI screenshots against reference images?

Automate visual verification by comparing generated UI screenshots to reference images to score visual fidelity. This process evaluates UI components, layouts, typography, and color, returning a strict JSON verdict to drive iterative design edits and automated release gating.

What is a deterministic JSON verdict in UI visual testing?

A deterministic JSON verdict in UI visual testing is a strict data payload representing the pass/fail state of a screenshot comparison. It includes a score, verdict, category match, differences, suggestions, and reasoning, enabling automated quality assurance pipelines.

Can I use image diff for automated quality assurance across multiple screens?

Yes, you can apply image diff for automated quality assurance across multiple screens. The visual-diff process identifies and scores visual fidelity between generated UI and reference images, ensuring consistent UI style, layout, and color before release.

Does visual regression testing work without external dependencies?

Visual regression testing can operate with zero dependencies, relying solely on internal logic to compare UI screenshots and reference images. It processes the images and generates a strict JSON payload with scores and verdicts without requiring external modules.

What is the best way to gate UI releases using screenshot comparison?

The best way to gate UI releases using screenshot comparison is to parse the deterministic JSON verdict returned by the visual-diff process. Automated pipelines can evaluate the score and category match data to block or approve releases based on visual fidelity thresholds.

Why does my visual QA process return inconsistent UI testing results?

Inconsistent UI testing results often occur when visual QA lacks deterministic scoring. By applying a strict image-diff mechanism to compare screenshots against reference images, the process returns a stable JSON verdict with specific differences and reasoning for reliable automation.