비주얼 QA (웹·터미널 UI 검증)
UI를 만들거나 수정한 뒤 스크린샷·터미널 캡처를 픽셀 단위로 비교하고 두 명의 독립 리뷰어를 병렬로 돌려 최종 합격/불합격을 내리는 시각 품질 검증 스킬.
디자인·UI고급★ 67,531⑂ 5,507AI 점수 9/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
- 웹 페이지/컴포넌트와 터미널(TUI) UI 두 가지 표면을 자동으로 구분해 각기 다른 캡처 전략을 적용합니다.
- 동봉된 Node CLI(
scripts/visual-qa.mjs)로image-diff(픽셀 차이율, 유사도 점수, 핫스팟 좌표, 알파 채널 검사)와tui-check(최대 폭, 오버플로 라인, 테두리 정렬, 전각 문자 열)을 실행해 객관적 증거 JSON을 남깁니다. - 그 증거를 근거로 읽기 전용 서브에이전트 2개를 동시에 띄웁니다. Pass A는 "진짜 디자인 시스템인지 vs 이미지로 눌러 붙인 가짜인지", 기능 동작, 반응형, 알파 처리, 무의미한 슬롭 애니메이션을 점검하고, Pass B는 레퍼런스와의 픽셀 대조 및 한국어/일본어/중국어 줄바꿈·클리핑 정밀 검사를 담당합니다.
- 두 결과를 하나의 표 형식 판정 리포트로 합치고, "모든 페이지를 새로 캡처한 상태에서 독립 리뷰어가 BLOCKING 없이 PASS"할 때까지 루프를 강제합니다.
- 사이트 클론·Figma → 코드 같은 작업에는 픽셀 대조 오라클 + 코드 레벨 디자인 시스템 오라클을 추가로 요구하는 레퍼런스 충실도 모드가 따로 있습니다.
이런 분께 추천
- 프런트엔드/디자인 시스템 개발자, 목업을 픽셀 단위로 재현해야 하는 클론·리뉴얼 프로젝트 담당자.
- 한글·일본어·중국어 UI에서 조사만 다음 줄로 떨어지거나 글자가 잘리는 문제를 반복적으로 겪는 팀.
- CLI/TUI 앱을 만들며 박스 문자 정렬과 전각 문자 폭 깨짐을 검증해야 하는 개발자.
- 에이전트가 "다 됐습니다"라고 자체 승인하는 것을 막고 싶은 사람.
활용 예시
- 랜딩 페이지를 Figma 시안대로 구현한 뒤: 시안 PNG와 동일 뷰포트 실제 스크린샷을 찍어
image-diff를 돌리고, 핫스팟이 헤더 우측에 몰린 원인을 두 리뷰어가 각각 코드·픽셀 관점에서 지적하게 합니다. - 40장짜리 슬라이드 덱/다중 라우트 앱: 5장만 샘플링하지 않고 전 페이지를 열거해 캡처하고, 리뷰어에게 페이지 수를 알려 누락 여부까지 확인시킵니다.
- Node 기반 TUI 대시보드: 실제 pty → xterm.js 렌더 → PNG 캡처 후
tui-check --cols 80으로 3번째 줄이 2칸 넘치고 전각 문자 12~13열에서 테두리가 깨진 것을 찾아 수정합니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/HEAD/packages/shared-skills/skills/visual-qa/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 code-yeongyu/oh-my-openagent 의 packages/shared-skills/skills/visual-qa 폴더를 내 ~/.claude/skills/visual-qa/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/code-yeongyu/oh-my-openagent.git && mkdir -p ~/.claude/skills && cp -r oh-my-openagent/packages/shared-skills/skills/visual-qa ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 스킬을 보관할 임시 폴더로 이동합니다.
- 저장소를 클론합니다:
git clone https://github.com/code-yeongyu/oh-my-openagent.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r oh-my-openagent/packages/shared-skills/skills/visual-qa ~/.claude/skills/ ls ~/.claude/skills/visual-qa로SKILL.md와scripts/visual-qa.mjs가 있는지 확인합니다.- Node.js가 설치되어 있는지 확인합니다(
node -v). 스크립트 실행에 필요합니다. - 웹 캡처 도구가 없다면 설치합니다:
npm install -g agent-browser && agent-browser install(또는 프로젝트에 이미 있는 Playwright 사용). - Claude Code를 재시작하고 "이 화면 비주얼 QA 해줘"처럼 요청하면 스킬이 발동합니다.
- 참고: TUI 캡처 예시는 원 저장소 전용 스크립트를 사용하므로, 다른 프로젝트에서는 "실제 pty → xterm.js → PNG" 패턴을 직접 준비하거나 텍스트 캡처만으로
tui-check를 사용하세요.
GitHub에서 원본 보기 ↗라이선스: NOASSERTION