visual-verdict
Structured visual QA verdict for screenshot-to-reference comparisons
- License 许可
- MIT
- 最近更新
- 2026-04-14
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- visual-verdict
- description
- Structured visual QA verdict for screenshot-to-reference comparisons
03 SKILL.md 正文
<Purpose> Use this skill to compare generated UI screenshots against one or more reference images and return a strict JSON verdict that can drive the next edit iteration. </Purpose>
<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>
<Inputs>
reference_images[](one or more image paths)generated_screenshot(current output image)- Optional:
category_hint(e.g.,hackernews,sns-feed,dashboard) </Inputs>
<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$visual-verdictbefore any further code edits in the next iteration. - Persist the verdict in
.omx/state/{scope}/ralph-progress.jsonwith both:- numeric signal (
score, threshold pass/fail) - qualitative signal (
reasoning,suggestions,next_actions) </Threshold_And_Loop>
- numeric signal (
<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>
<Example>
{
"score": 87,
"verdict": "revise",
"category_match": true,
"differences": [
"Top nav spacing is tighter than reference",
"Primary button uses smaller font weight"
],
"suggestions": [
"Increase nav item horizontal padding by 4px",
"Set primary button font-weight to 600"
],
"reasoning": "Core layout matches, but style details still diverge."
}
</Example>
04 同仓库更多 Skills
webapp-testing
To test local web applications, write native Python Playwright scripts.
python-packaging
Comprehensive guide to creating, structuring, and distributing Python packages using modern packaging tools, pyproject.toml, and publishing to PyPI.
canvas-design
These are instructions for creating design philosophies - aesthetic movements that are then EXPRESSED VISUALLY. Output only .md files, .pdf files, and .png files.
webapp-testing
To test local web applications, write native Python Playwright scripts.
slack-gif-creator
A toolkit providing utilities and knowledge for creating animated GIFs optimized for Slack.
frontend-design
You are a frontend designer-engineer, not a layout generator.