Communitygithub.com

visual-verdict

생성된 UI 스크린샷을 참조 이미지와 비교하여 구조화된 시각적 QA 판정을 JSON 형식으로 반환합니다.

visual-verdict란 무엇인가요?

이 스킬은 생성된 UI 스크린샷을 하나 이상의 참조 이미지와 비교하고, 엄격한 JSON 판정(verdict)을 반환하여 다음 편집 반복을 안내합니다. 레이아웃, 간격, 타이포그래피, 컴포넌트 스타일링 등 시각적 충실도가 요구되는 작업에 유용하며, Claude Code 환경에서 사용할 수 있습니다. 입력으로 참조 이미지 경로 리스트, 생성된 스크립샷, 선택적 카테고리 힌트를 받아 0-100 점수와 'pass', 'revise', 'fail' 판정을 내립니다. 점수가 90 미만이면 편집을 계속하고 다시 이 스킬을 실행해야 하며, 디버깅 시 픽셀 수준 차이 도구를 보조적으로 활용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/visual-verdict

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

<목적> 이 스킬은 생성된 UI 스크린샷을 하나 이상의 참조 이미지와 비교하고, 엄격한 JSON 판정을 반환하여 다음 편집 반복을 안내합니다. </목적>

<사용_조건>

  • 작업에 시각적 충실도 요구사항(레이아웃, 간격, 타이포그래피, 컴포넌트 스타일링)이 포함된 경우
  • 생성된 스크린샷과 최소 하나의 참조 이미지가 있는 경우
  • 편집을 계속하기 전에 결정적인 합격/불합격 지침이 필요한 경우 </사용_조건>

<입력>

  • reference_images[] (하나 이상의 이미지 경로)
  • generated_screenshot (현재 출력 이미지)
  • 선택사항: category_hint (예: hackernews, sns-feed, dashboard) </입력>

<출력_계약> JSON만 반환하며 정확한 형태는 다음과 같습니다:

{
  "score": 0,
  "verdict": "revise",
  "category_match": false,
  "differences": ["..."],
  "suggestions": ["..."],
  "reasoning": "짧은 설명"
}

규칙:

  • score: 정수 0-100
  • verdict: 짧은 상태 (pass, revise, fail)
  • category_match: 생성된 스크린샷이 의도한 UI 카테고리/스타일과 일치하면 true
  • differences[]: 구체적인 시각적 불일치 (레이아웃, 간격, 타이포그래피, 색상, 계층 구조)
  • suggestions[]: 차이점과 연결된 실행 가능한 다음 편집 사항
  • reasoning: 1-2 문장 요약

<임계값_및_반복>

  • 목표 합격 임계값은 **90+**입니다.
  • score < 90이면 편집을 계속하고 추가 시각적 검토 전에 /oh-my-claudecode:visual-verdict를 다시 실행하십시오.
  • 다음 스크린샷이 임계값을 넘을 때까지 시각적 작업이 완료된 것으로 간주하지 마십시오. </임계값_및_반복>

<디버그_시각화> 불일치 진단이 어려울 때:

  1. $visual-verdict를 권위 있는 결정으로 유지하십시오.
  2. 픽셀 수준 차이 도구(pixel diff / pixelmatch overlay)를 보조 디버그 도구로 사용하여 문제 지점을 찾으십시오.
  3. 픽셀 차이 문제 지점을 구체적인 differences[] 및 suggestions[] 업데이트로 변환하십시오. </디버그_시각화>

<예시>

{
  "score": 87,
  "verdict": "revise",
  "category_match": true,
  "differences": [
    "상단 네비게이션 간격이 참조보다 좁음",
    "기본 버튼이 더 작은 글꼴 두께를 사용함"
  ],
  "suggestions": [
    "네비게이션 항목 가로 패딩을 4px 증가",
    "기본 버튼 font-weight를 600으로 설정"
  ],
  "reasoning": "핵심 레이아웃은 일치하지만 스타일 세부 사항이 여전히 차이가 있습니다."
}

</예시>

작업: {{ARGUMENTS}}

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

agent-doc-discipline

Writing-time discipline for documents agents consume (the five surfaces, specs, tickets, .omc/skills/) — every rule checkable and carrying a why, steps before reference, one meaning in one home, no restating what the environment already says. Mandatory at drydock seed generation and the launch C5 sediment pass; opt-in for any other agent-facing doc edit. The companion of minimal-code-discipline: that one disciplines code, this one disciplines papers.

ai-slop-cleaner

Clean AI-generated code slop with a regression-safe, deletion-first workflow and optional reviewer-only mode

ask

Process-first advisor routing for Claude, Codex, Gemini, Antigravity, Grok, or Cursor via `omc ask`, with artifact capture and no raw CLI assembly

ask-navigator

Shipyard

autopilot

Full autonomous execution from idea to working code

autoresearch

Stateful single-mission improvement loop with strict evaluator contract, markdown decision logs, and max-runtime stop behavior

cancel

Cancel any active OMC mode (autopilot, ralph, ultragoal, swarm, ultrapilot, pipeline, team) and clean up retired legacy state

configure-notifications

Configure notification integrations (Telegram, Discord, Slack) via natural language

debug

Diagnose the current OMC session or repo state using logs, traces, state, and focused reproduction

deepinit

Deep codebase initialization with hierarchical AGENTS.md documentation

deep-interview

Socratic deep interview with mathematical ambiguity gating before explicit execution approval

drydock

Lay the keel of the shipyard harness in any repo — the 4-pillar shared environment (Context, Rules, Tools, Standards) across 5 surfaces (CLAUDE.md, skills, design-system, mcp/cli, shared context) so that every human and agent inherits the same design language and anyone can ship. Run once per repo; re-run with --check to audit drift.

execute

Carry an approved task through to working, verified code

external-context

Invoke parallel document-specialist agents for external web searches and documentation lookup

graph

Deterministic orchestration graph runtime - declarative DAG pipelines with journal-based crash recovery

harbor

Harbor intake for external work — the captain only handles unresolved decisions. Sweeps incoming issues and PRs, verifies every claim before disposition, reuses every decision already made, and hands the maintainer a docket whose pending items each carry one question with options, recommendation, impact and evidence. Agent-autonomous for facts and for actions covered by standing authorization; signed for every new judgment. Never merges.

hud

Configure HUD display options (layout, presets, display elements)

launch

Shipyard

loft

Loft the shape before cutting steel — answer a design question that prose cannot settle by building a throwaway artifact: a pure logic module in a clickable shell, or structurally different UI variants behind one route. The captain reacts to the artifact; the answer folds into the decision; the artifact never docks. Use when a design question stalls in words, when a navigator map carries a loft ticket, or when a spec discussion reaches

minimal-code-discipline

YAGNI-ladder coding discipline for writing changes — existence-first, reuse before writing, dependency ladder, shortest correct diff, with non-negotiables that must never be minimized away

관련 스킬