visual-verdict

Agent Skills › Yeachan-Heo/oh-my-claudecode › visual-verdict

visual-verdict

GitHub

用于对比生成UI截图与参考图，输出结构化JSON质检结果以驱动迭代。当需确保视觉保真度（布局、样式等）且存在参考图时触发，通过评分决定是否需要继续修改。

skills/visual-verdict/SKILL.md Yeachan-Heo/oh-my-claudecode

Trigger Scenarios

需要检查UI视觉保真度有生成的截图和参考图片需要确定性的通过/失败判定

Install

npx skills add Yeachan-Heo/oh-my-claudecode --skill visual-verdict -g -y

More Options

Use without installing

npx skills use Yeachan-Heo/oh-my-claudecode@visual-verdict

指定 Agent (Claude Code)

npx skills add Yeachan-Heo/oh-my-claudecode --skill visual-verdict -a claude-code -g -y

安装 repo 全部 skill

npx skills add Yeachan-Heo/oh-my-claudecode --all -g -y

预览 repo 内 skill

npx skills add Yeachan-Heo/oh-my-claudecode --list

SKILL.md

Frontmatter

{
    "name": "visual-verdict",
    "level": 2,
    "description": "Structured visual QA verdict for screenshot-to-reference comparisons"
}

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.

<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>

- `reference_images[]` (one or more image paths) - `generated_screenshot` (current output image) - Optional: `category_hint` (e.g., `hackernews`, `sns-feed`, `dashboard`)

<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:

Keep $visual-verdict as 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[] and suggestions[] updates. </Debug_Visualization>

```json { "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." } ```

Task: {{ARGUMENTS}}