Community코딩 & 개발github.com

visual-qa

필수 스크린샷 기반 시각적 QA 루프 — 사이트를 실행하고, Playwright로 모든 브레이크포인트를 캡처하고, 각 스크린샷을 평가하고, 수정하고, 반복합니다. 페이지나 섹션을 빌드하거나 리스타일한 후, UI 작업을 완료했다고 보고하기 전에 사용하세요. 디자인 판단에는 premium-frontend를, 전환 감사에는 conversion-optimization을 사용하세요.

visual-qa란 무엇인가요?

이 스킬은 프런트엔드 개발자가 UI 변경 사항을 보고하기 전에 체계적인 시각적 QA를 수행하도록 돕습니다. 개발 서버를 로컬에서 실행하고, 375px에서 1920px에 이르는 6가지 미리 정의된 브레이크포인트에서 Playwright로 전체 페이지 스크린샷을 캡처합니다. 그런 다음 각 스크린샷을 레이아웃 문제, 계층 구조 약점, 일관되지 않은 여백, 타이포그래피 결함, CTA 가시성, 모바일 관련 문제(예: 가로 스크롤, 탭 대상, 이미지 크롭)에 대해 검토합니다. 이 스킬은 발견된 문제를 수정하고 다시 캡처하여 반복하는 엄격한 루프를 강조하며, 동일한 문제가 재발하면 페이지 수준이 아닌 블록 라이브러리에서 수정하도록 지시합니다. Claude Code, Cursor, Codex 등 AI 에이전트와 함께 사용하도록 설계되었으며, '보고하기 전에 본다'는 원칙을 자동화합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/artem2167/website-factory/tree/HEAD/.claude/skills/visual-qa

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

visual-qa은(는) 무엇을 하나요?

유효한 JSX가 좋은 디자인을 증명하지는 않습니다. UI 작업을 완료했다고 보고하기 전에 반드시 시각적으로 확인하세요.

핵심

웹사이트를 로컬에서 실행하세요.

검사:
375px
390px
768px
1440px
1920px

스크린샷을 캡처하세요.

각 스크린샷을 다음 항목에 대해 검토하세요:

- 깨진 레이아웃
- 약한 계층 구조
- 과도한 여백
- 부족한 여백
- 보기 흉한 줄 바꿈
- 잘못된 이미지 크롭
- 일관되지 않은 여백
- 지나치게 큰 타이포그래피
- 지나치게 작은 타이포그래피
- 약한 CTA 가시성
- 정렬 문제
- 일반적인 AI 디자인 패턴

발견된 문제를 수정하세요.

주요 시각적 문제가 없을 때까지 반복하세요.

실행 방법

개발 서버를 시작한 후:

QA_ROUTES=/,/services,/doctors,/contact node scripts/qa-screenshots.mjs

출력은 qa/<route>/<width>.png에 전체 페이지로, 브레이크포인트당 하나의 파일로 저장됩니다. 스크립트는 브레이크포인트당 가로 오버플로와 콘솔 오류도 보고합니다 — 둘 다 자동 실패로 간주됩니다.

캡처되는 브레이크포인트: 375×812, 390×844, 430×932, 768×1024, 1440×900, 1920×1080.

최초 설정:

npm i -D playwright && npx playwright install chromium

전체 스윕 대신 대화형으로 탐색하려면 에디터 내 브라우저 도구가 더 빠릅니다: 페이지를 열고, 크기를 조정하고, 접근성 트리를 읽고, 콘솔을 확인하세요.

스크린샷 읽기

브레이크포인트별로 진행하세요. 각각에 대해 다음 질문에 답하세요:

  1. 가로로 오버플로되는 요소가 있습니까?
  2. 명확한 초점이 하나 있습니까, 아니면 눈이 분산됩니까?
  3. 제목이 보기 흉한 고아 단어나 한 단어로 마지막 줄이 바뀌었습니까?
  4. 섹션 간 여백이 일관되어야 할 곳에서는 일관되고, 의도적으로 달라야 할 곳에서는 확연히 다릅니까?
  5. 이미지가 얼굴, 접시 또는 침대를 통해 크롭되었습니까?
  6. 기본 CTA가 해당 화면에서 가장 눈에 띄는 요소입니까?
  7. 모바일에서: 고정 CTA가 보이고, 엄지손가락으로 닿기 쉬우며, 콘텐츠를 가리지 않습니까?
  8. 기본 AI 페이지처럼 보이는 요소(그라데이션, 아이콘 카드 그리드, 알약 배지, 흐릿한 블롭)가 있습니까?

모바일 전용 확인 사항

지역 비즈니스 방문자는 Instagram, Google Maps, TikTok, 광고 및 메신저 링크를 통해 유입됩니다. 모바일은 부차적인 고려 사항이 아닌 주요 표면입니다.

  • 375px에서 가로 스크롤이 없어야 함;
  • 히어로 텍스트가 너무 커서 첫 화면 전체를 차지하지 않아야 함;
  • 탭 대상이 충분히 크고, 작은 것이 없어야 함;
  • 내비게이션에 접근 가능하고 닫을 수 있어야 함;
  • 이미지가 세로 모드에 맞게 크롭되고, 가로 데스크톱 크롭에서 찌그러지지 않아야 함;
  • 고정 CTA가 있고 정제되어 있어야 함.

루프 규율

  • 문제를 수정한 후 다시 캡처하세요. 블라인드로 수정하지 마세요.
  • 목록이 지루해질 때가 아니라, 전체 스윕에서 주요 문제가 발견되지 않을 때 중단하세요.
  • 수정 후 동일한 문제가 다시 나타나면, 페이지가 아닌 블록에 문제가 있는 것입니다 — 블록 라이브러리에서 수정하세요.
  • 정직하게 보고하세요: 브레이크포인트에 여전히 미해결 문제가 있다면 그렇게 말하세요.

Individual skills in this repo

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

관련 스킬