visual-qa

Installation
SKILL.md

Visual QA - Dual-Oracle Web and TUI Verification

Verify a rendered UI against intent using objective script evidence plus two parallel read-only oracle passes, then synthesize one good/bad verdict. The script numbers focus the reviewers. They are not the verdict.

Purpose and when to use

  • Use after you build or change any UI, before calling it done. Covers web/page UIs and TUI/terminal UIs.
  • Use when output must match a mock, a baseline, or a stated design intent; when you suspect a regression; when CJK (Korean/Japanese/Chinese) text may clip, misalign, or wrap awkwardly; when a claimed design system might actually be a flat image; when a terminal layout may overflow or its borders may break.
  • Skip when there is no rendered surface (pure backend or library logic with no visual or terminal output). For broad post-implementation review use review-work; this skill is the visual specialist.

In the commands below, $SKILL_DIR is this skill's own directory (the folder containing this SKILL.md). The bundled script lives at scripts/cli.ts inside it.

Step 1 - Detect the surface

  • Web/page UI: renders in a browser (HTML/CSS/JS, components, canvas, SVG). Evidence is screenshots.
  • TUI/terminal UI: renders as text in a terminal (box-drawing, panes, status lines, REPL/TUI apps). Evidence is terminal captures.
  • Reference-fidelity UI: any web/page UI built from a concrete reference packet, including screenshots, generated Imagen/Stitch mockups, Figma exports, overview text, annotations, or source-site captures. Evidence is the full reference packet plus same-size actual captures.

If the change touches both, run both capture tracks and feed both into the passes.

Installs
1
GitHub Stars
63.9K
First Seen
1 day ago
visual-qa — code-yeongyu/oh-my-openagent