CommunityProgramación y desarrollogithub.com

visual-qa

Bucle de QA visual obligatorio basado en capturas de pantalla para cualquier cambio significativo en la interfaz: ejecuta el sitio, captura cada punto de interrupción con Playwright, evalúa cada captura, corrige, repite. Se usa después de construir o rediseñar cualquier página o sección, y antes de informar que el trabajo de UI está terminado. Para juicio de diseño usa premium-frontend; para auditoría de conversión usa conversion-optimization.

¿Qué es visual-qa?

Este skill de QA visual automatizado garantiza que ningún cambio significativo en la interfaz se reporte como terminado sin haber sido inspeccionado visualmente. Está diseñado para desarrolladores que trabajan con frameworks modernos (React, Next.js, etc.) y usan Playwright para capturar capturas de pantalla en múltiples puntos de interrupción. El flujo de trabajo consiste en ejecutar el servidor de desarrollo local, usar un script de Node.js que genera capturas de pantalla completas para rutas y anchos específicos (375px, 390px, 768px, 1440px, 1920px), y luego revisar cada captura en busca de problemas como diseño roto, jerarquía débil, espaciado excesivo o insuficiente, tipografía mal ajustada, recortes de imagen pobres, márgenes inconsistentes, prominencia de CTA débil, problemas de alineación y patrones genéricos de IA. El proceso se repite hasta que no queden problemas visuales importantes. El skill también incluye verificaciones específicas para móviles, como desplazamiento horizontal, tamaño de objetivos táctiles y visibilidad del CTA fijo. La salida se guarda en carpetas `qa/<ruta>/<ancho>.png`, y el script también reporta desbordamiento horizontal y errores de consola. Se enfatiza la disciplina de bucle: corregir y recapturar, no corregir a ciegas, y detenerse solo cuando un barrido completo no produzca hallazgos importantes.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace visual-qa?

El JSX válido no es evidencia de buen diseño. Nunca reportes el trabajo de UI como terminado sin haberlo inspeccionado.

Núcleo

Ejecuta el sitio web localmente.

Inspecciona:
375px
390px
768px
1440px
1920px

Captura capturas de pantalla.

Revisa cada captura en busca de:

- diseño roto
- jerarquía débil
- espacio en blanco excesivo
- espacio en blanco insuficiente
- ajuste de línea feo
- recorte de imagen pobre
- márgenes inconsistentes
- tipografía sobredimensionada
- tipografía minúscula
- prominencia de CTA débil
- problemas de alineación
- patrones genéricos de diseño IA

Corrige los problemas detectados.

Repite hasta que no queden problemas visuales importantes.

Cómo ejecutarlo

Inicia el servidor de desarrollo, luego:

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

La salida se guarda en qa/<ruta>/<ancho>.png, a página completa, un archivo por punto de interrupción. El script también reporta desbordamiento horizontal y errores de consola por punto de interrupción: ambos son fallos automáticos.

Puntos de interrupción capturados: 375×812, 390×844, 430×932, 768×1024, 1440×900, 1920×1080.

Configuración inicial:

npm i -D playwright && npx playwright install chromium

Para inspecciones interactivas en lugar de un barrido completo, las herramientas de navegador en el editor son más rápidas: abre la página, redimensiona, lee el árbol de accesibilidad, revisa la consola.

Lectura de una captura de pantalla

Ve punto de interrupción por punto de interrupción. Para cada uno, responde:

  1. ¿Se desborda algo horizontalmente?
  2. ¿Hay un punto focal obvio o el ojo divaga?
  3. ¿Los encabezados se envuelven formando un huérfano feo o una última línea de una sola palabra?
  4. ¿Los márgenes entre secciones son consistentes donde deberían serlo, y deliberadamente diferentes donde deberían serlo?
  5. ¿Las imágenes están recortadas a través de una cara, un plato o una cama?
  6. ¿El CTA principal es el elemento más prominente en su pantalla?
  7. En móvil: ¿el CTA fijo es visible, accesible con el pulgar y no cubre contenido?
  8. ¿Algo parece una página de IA predeterminada — degradado, cuadrícula de iconos, insignias de pastilla, manchas borrosas?

Verificaciones específicas para móvil

Los visitantes de negocios locales llegan desde Instagram, Google Maps, TikTok, anuncios y enlaces de mensajería. El móvil es la superficie principal, no un complemento.

  • sin desplazamiento horizontal a 375;
  • texto del héroe no sobredimensionado — no debe ocupar toda la primera pantalla;
  • objetivos táctiles lo suficientemente grandes, nada diminuto;
  • navegación accesible y cerrable;
  • imágenes recortadas para retrato, no comprimidas desde un recorte de escritorio apaisado;
  • CTA fijo presente y refinado.

Disciplina de bucle

  • Corrige los hallazgos, luego vuelve a capturar. No corrijas a ciegas.
  • Detente cuando un barrido completo no produzca hallazgos importantes, no cuando la lista se vuelva aburrida.
  • Si el mismo hallazgo vuelve después de una corrección, el problema está en el bloque, no en la página — corrígelo en la biblioteca de bloques.
  • Informa honestamente: si un punto de interrupción aún tiene un problema abierto, dilo.

Individual skills in this repo

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

Skills relacionados