visual-verdict

SkillAI & models

Visual-verdict is a skill that lets an AI agent compare screenshots against a reference design and return a structured pass/fail verdict. It turns visual QA checks into a repeatable, machine-readable result instead of a free-form opinion.

Use visual-verdict in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add visual-verdict and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the visual-verdict skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Have an AI agent that can load skills.

visual-verdictStart free

What your AI can do with it

  • Compare a screenshot against a reference design
  • Produce a structured pass/fail verdict
  • Support screenshot-to-reference comparison workflows for visual QA

Getting started

  1. Have an AI agent that can load skills.
  2. Add the visual-verdict skill to the agent's available skills.
  3. Provide a screenshot and a reference design, then ask the agent to compare them and return the verdict.

What this skill tells your AI

The instructions your AI receives, as published by yeachan-heo/oh-my-claudecode in skills/visual-verdict/SKILL.md and read by ahel’s review.

<Use_When>

  • The task includes visual fidelity requirements (layout, spacing, typography, component styling)
  • You have a generated screenshot and at least one reference image
  • You need deterministic pass/fail guidance before continuing edits </Use_When>

<Output_Contract> Return JSON only with this exact shape:

{
  "score": 0,
  "verdict": "revise",
  "category_match": false,
  "differences": ["..."],
  "suggestions": ["..."],
  "reasoning": "short explanation"
}

Rules:

  • score: integer 0-100
  • verdict: short status (pass, revise, or fail)
  • category_match: true when the generated screenshot matches the intended UI category/style
  • differences[]: concrete visual mismatches (layout, spacing, typography, colors, hierarchy)
  • suggestions[]: actionable next edits tied to the differences
  • reasoning: 1-2 sentence summary

<Threshold_And_Loop>

  • Target pass threshold is 90+.
  • If score < 90, continue editing and rerun /oh-my-claudecode:visual-verdict before any further visual review pass.
  • Do not treat the visual task as complete until the next screenshot clears the threshold. </Threshold_And_Loop>

<Debug_Visualization> When mismatch diagnosis is hard:

  1. Keep $visual-verdict as the authoritative decision.
  2. Use pixel-level diff tooling (pixel diff / pixelmatch overlay) as a secondary debug aid to localize hotspots.
  3. Convert pixel diff hotspots into concrete differences[] and suggestions[] updates. </Debug_Visualization>

Task: {{ARGUMENTS}}

Signals

GitHub stars
39k
Forks
4k
Last commit
Oct 2026

Questions

What does the verdict look like?
It is a structured pass/fail result from comparing a screenshot against a reference design.
Do I need a reference design to use it?
Yes, the skill compares a screenshot against a reference design, so both are needed.
Advanced
Item type
skill
Key
visual-verdict
Source
github.com/yeachan-heo/oh-my-claudecode