visual-verdict
SkillAI & modelsVisual-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.
Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.
No other account needed.
Have an AI agent that can load skills.
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
- Have an AI agent that can load skills.
- Add the visual-verdict skill to the agent's available skills.
- 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-100verdict: short status (pass,revise, orfail)category_match:truewhen the generated screenshot matches the intended UI category/styledifferences[]: concrete visual mismatches (layout, spacing, typography, colors, hierarchy)suggestions[]: actionable next edits tied to the differencesreasoning: 1-2 sentence summary
<Threshold_And_Loop>
- Target pass threshold is 90+.
- If
score < 90, continue editing and rerun/oh-my-claudecode:visual-verdictbefore 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:
- Keep
$visual-verdictas the authoritative decision. - Use pixel-level diff tooling (pixel diff / pixelmatch overlay) as a secondary debug aid to localize hotspots.
- Convert pixel diff hotspots into concrete
differences[]andsuggestions[]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
github.com/yeachan-heo/oh-my-claudecode
More in AI & models
Skill · anthropics
More in AI & modelswayfinder
Skill · mattpocock
More in AI & modelswizard
Skill · mattpocock
More in AI & modelsalgorithmic-art
Skill · anthropics
More in AI & modelscode-review-and-quality
Skill · addyosmani
More in AI & modelsai-first-engineering
Skill · affaan-m
More in AI & models