visual-verdict

Compare UI screenshots against reference images and output a structured JSON verdict.

5|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/RobinNorberg/oh-my-copilot --skill visual-verdict-robinnorberg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-verdict
Source: https://github.com/RobinNorberg/oh-my-copilot/tree/main/skills/visual-verdict
Command: npx skills add https://github.com/RobinNorberg/oh-my-copilot --skill visual-verdict-robinnorberg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Compare generated UI screenshots against reference images and return a strict JSON verdict to drive the next edit iteration.

Core Features & Use Cases

  • Deterministic pass/fail verdicts for visual QA based on pixel-level differences between current render and references.
  • JSON output with fields: score, verdict, category_match, differences, suggestions, and reasoning to guide remediation.
  • Supports multiple reference images and optional category hints to improve contextual evaluation.

Quick Start

Use the visual-verdict skill to evaluate a screenshot against a set of reference images and obtain a deterministic 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 regression testing and get a structured JSON verdict?

UI visual regression is detected by comparing generated screenshots against reference images to identify pixel-level differences. The skill evaluates layout, typography, and styling concerns across screen sizes and themes to produce a deterministic pass or fail outcome.

How do I compare UI screenshots against reference images for visual QA?

You compare UI screenshots against reference images by applying the visual-verdict skill to evaluate pixel-level differences. It returns a strict JSON payload including score, verdict, category_match, differences, suggestions, and reasoning to guide the next edit iteration.

Can I use screenshot diff results to automatically guide UI remediation?

Screenshot diff results can automatically guide UI remediation through the structured JSON output. The returned payload contains specific suggestions and reasoning fields that provide actionable feedback for correcting layout, typography, and styling regressions.

Does visual regression testing work across different screen sizes and themes?

Visual regression testing works across different screen sizes and themes by applying the evaluation to UI components with layout, typography, and styling concerns. Multiple reference images and optional category hints can be supplied to improve contextual evaluation accuracy.

What is the best way to get a deterministic pass/fail verdict for UI visual QA?

The best way to get a deterministic pass/fail verdict for UI visual QA is to compare current renders against reference images using a structured evaluation method. This approach returns a strict JSON payload with a score and verdict to ensure consistent, reliable results.

What fields are included in JSON output for visual regression testing?

JSON output for visual regression testing includes the fields score, verdict, category_match, differences, suggestions, and reasoning. This strict JSON payload ensures deterministic evaluation and provides structured data to guide the next edit iteration.