visual-qa

Loop obrigatório de QA visual com screenshots para qualquer mudança significativa de UI — execute o site, capture cada breakpoint com Playwright, avalie cada screenshot, corrija, repita. Use após construir ou reformatar qualquer página ou seção, e antes de relatar o trabalho de UI como concluído.

O que é visual-qa?

Esta skill força uma verificação visual disciplinada antes que qualquer trabalho de UI seja dado como concluído. O fluxo de trabalho é: executar o site localmente, capturar screenshots em 375px, 390px, 768px, 1440px e 1920px usando Playwright e, em seguida, revisar cada screenshot em busca de problemas como layout quebrado, hierarquia fraca e espaçamentos inconsistentes. A skill também detecta automaticamente overflow horizontal e erros de console por breakpoint. Após corrigir os problemas, o loop se repete até que uma varredura completa não produza nenhum achado relevante. Ideal para desenvolvedores front-end que usam Claude Code ou ferramentas similares, garantindo que as interfaces não apenas funcionem, mas tenham uma aparência profissional e refinada antes do deploy.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que visual-qa faz?

JSX válido não é evidência de bom design. Nunca reporte trabalho de UI como concluído sem ter olhado para ele.

Núcleo

Execute o site localmente.

Inspecione:
375px
390px
768px
1440px
1920px

Capture screenshots.

Revise cada screenshot em busca de:

- layout quebrado
- hierarquia fraca
- espaçamento excessivo
- espaçamento insuficiente
- quebra de linha feia
- corte de imagem ruim
- margens inconsistentes
- tipografia exagerada
- tipografia minúscula
- destaque fraco do CTA
- problemas de alinhamento
- padrões genéricos de design IA

Corrija os problemas detectados.

Repita até que nenhum problema visual significativo permaneça.

Como executar

Inicie o servidor de desenvolvimento e então:

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

A saída vai para qa/<rota>/<largura>.png, em página cheia, um arquivo por breakpoint. O script também reporta overflow horizontal e erros de console por breakpoint — ambos são falhas automáticas.

Breakpoints capturados: 375×812, 390×844, 430×932, 768×1024, 1440×900, 1920×1080.

Configuração inicial:

npm i -D playwright && npx playwright install chromium

Para análises interativas em vez de uma varredura completa, as ferramentas do navegador no editor são mais rápidas: abra a página, redimensione, leia a árvore de acessibilidade, verifique o console.

Lendo um screenshot

Vá breakpoint por breakpoint. Para cada um, responda:

  1. Há algo transbordando horizontalmente?
  2. Há um ponto focal óbvio, ou o olho vagueia?
  3. Os títulos quebram em uma órfã feia ou em uma última linha de uma palavra?
  4. As margens entre as seções são consistentes onde deveriam ser e deliberadamente diferentes onde deveriam ser?
  5. As imagens estão cortadas através de um rosto, um prato ou uma cama?
  6. O CTA principal é o elemento mais proeminente em sua tela?
  7. No celular: o CTA fixo está visível, acessível ao polegar e não está cobrindo conteúdo?
  8. Algo parece uma página de IA padrão — gradiente, grade de ícones e cartões, badges de pílula, bolhas borradas?

Verificações específicas para celular

Visitantes de negócios locais chegam do Instagram, Google Maps, TikTok, anúncios e links de mensageiros. O celular é a superfície principal, não um complemento.

  • sem scroll horizontal em 375;
  • texto do herói não exagerado — não deve ocupar toda a primeira tela;
  • alvos de toque grandes o suficiente, nada minúsculo;
  • navegação alcançável e fechável;
  • imagens cortadas para retrato, não comprimidas de um corte de paisagem para desktop;
  • CTA fixo presente e refinado.

Disciplina do loop

  • Corrija os achados, depois recapture. Não corrija às cegas.
  • Pare quando uma varredura completa não produzir nenhum achado importante, não quando a lista ficar entediante.
  • Se o mesmo achado retornar após uma correção, o problema está no bloco, não na página — corrija-o na biblioteca de blocos.
  • Relate honestamente: se um breakpoint ainda tiver um problema em aberto, diga-o.

Individual skills in this repo

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

Habilidades Relacionadas