visual-verdict

Compare UI screenshots against reference images and generate a JSON pass/fail verdict.

6|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/Weihong-Liu/GenericAgent_project --skill visual-verdict-weihong-liu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-verdict
Source: https://github.com/Weihong-Liu/GenericAgent_project/tree/main/.codex/skills/visual-verdict
Command: npx skills add https://github.com/Weihong-Liu/GenericAgent_project --skill visual-verdict-weihong-liu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of comparing generated UI screenshots against reference images, providing a structured JSON verdict to guide the next iteration of edits.

Core Features & Use Cases

  • Visual QA Automation: Compare UI screenshots against reference images.
  • JSON Verdict: Generate a JSON verdict indicating pass/fail and suggesting edits.
  • Use Case: When you need to ensure visual consistency between a generated UI and a reference design.

Quick Start

Compare the generated screenshot 'output.png' with the reference image 'reference.png' using the visual-verdict skill.

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 QA for screenshot comparisons against a reference image?

Automate visual QA by using a skill that compares UI screenshots against reference images to generate a structured JSON verdict for pass/fail and suggest edits. This ensures visual consistency between generated UIs and reference designs.

How does screenshot validation generate actionable feedback for UI edits?

Screenshot validation generates actionable feedback by analyzing image differences and outputting a structured JSON verdict. This verdict indicates a pass or fail status and provides specific suggestions for the next iteration of UI edits.

Can I use this screenshot comparison skill without installing additional dependencies?

You cannot use this skill without additional dependencies, as it requires image comparison and analysis libraries to function. You must ensure your environment has the necessary image processing libraries installed before running the visual QA automation.

What is the best way to verify visual consistency between a generated UI and a reference design?

The best way to verify visual consistency is to run an automated screenshot-to-reference comparison. This process evaluates the generated UI screenshot against the reference image and produces a structured JSON verdict to guide any necessary edits.

Why does visual QA automation require image analysis libraries for screenshot validation?

Visual QA automation requires image analysis libraries because the skill relies on these tools to perform pixel-level screenshot comparison and detect visual discrepancies. Without these libraries, the skill cannot process the images or generate the structured JSON verdict.

Are there limitations when using automated screenshot validation for UI testing?

A limitation of automated screenshot validation is that it requires pre-existing reference images to function correctly. Additionally, the accuracy of the JSON verdict depends entirely on the capabilities of the underlying image comparison and analysis libraries used.