visual-qa

Boucle de validation visuelle obligatoire par capture d'écran pour toute modification significative de l'interface — exécutez le site, capturez chaque point de rupture avec Playwright, évaluez chaque capture, corrigez, répétez. À utiliser après avoir construit ou restylé une page ou une section, et avant de déclarer le travail d'interface comme terminé. Pour le jugement de design, utilisez premium-frontend ; pour l'audit de conversion, utilisez conversion-optimization.

Qu'est-ce que visual-qa ?

Cette compétence impose une boucle de validation visuelle systématique avant de déclarer un travail d'interface utilisateur comme terminé. Elle garantit que chaque modification significative de l'interface (construction ou restylage d'une page/section) est inspectée visuellement à plusieurs points de rupture critiques (375px, 390px, 768px, 1440px, 1920px) à l'aide de Playwright. L'utilisateur lance le serveur de développement, exécute un script qui capture des captures d'écran plein écran pour chaque route et point de rupture, puis examine chaque capture selon une liste de contrôle détaillée (mise en page, hiérarchie, espacement, typographie, CTA, recadrage d'images, etc.). Les problèmes détectés doivent être corrigés et la boucle répétée jusqu'à ce qu'aucun problème visuel majeur ne subsiste. La compétence inclut également des vérifications spécifiques aux mobiles (défilement horizontal, taille des cibles tactiles, CTA collant) et une discipline de boucle : ne pas corriger à l'aveugle, signaler honnêtement les problèmes persistants, et corriger les blocs réutilisables si un même problème revient.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait visual-qa ?

Un JSX valide n'est pas une preuve de bon design. Ne déclarez jamais un travail d'interface utilisateur comme terminé sans l'avoir examiné.

Cœur

Exécutez le site web localement.

Inspectez :
375px
390px
768px
1440px
1920px

Capturez des captures d'écran.

Examinez chaque capture d'écran pour :

- mise en page cassée
- hiérarchie faible
- espace blanc excessif
- espace blanc insuffisant
- saut de ligne disgracieux
- mauvais recadrage d'image
- marges incohérentes
- typographie surdimensionnée
- typographie minuscule
- faible proéminence du CTA
- problèmes d'alignement
- schémas de conception génériques IA

Corrigez les problèmes détectés.

Répétez jusqu'à ce qu'aucun problème visuel majeur ne subsiste.

Comment l'exécuter

Démarrez le serveur de développement, puis :

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

La sortie se trouve dans qa/<route>/<largeur>.png, plein écran, un fichier par point de rupture. Le script signale également les débordements horizontaux et les erreurs de console par point de rupture — les deux sont des échecs automatiques.

Points de rupture capturés : 375×812, 390×844, 430×932, 768×1024, 1440×900, 1920×1080.

Configuration initiale :

npm i -D playwright && npx playwright install chromium

Pour une exploration interactive plutôt qu'un balayage complet, les outils de navigation intégrés à l'éditeur sont plus rapides : ouvrez la page, redimensionnez, lisez l'arborescence d'accessibilité, vérifiez la console.

Lecture d'une capture d'écran

Allez point de rupture par point de rupture. Pour chacun, répondez :

  1. Y a-t-il un élément qui déborde horizontalement ?
  2. Y a-t-il un point focal évident, ou l'œil vagabonde-t-il ?
  3. Les titres se brisent-ils en un orphelin disgracieux ou une dernière ligne d'un seul mot ?
  4. Les marges entre les sections sont-elles cohérentes là où elles doivent l'être, et délibérément différentes là où elles doivent l'être ?
  5. Les images sont-elles recadrées à travers un visage, une assiette ou un lit ?
  6. Le CTA principal est-il l'élément le plus proéminent dans son écran ?
  7. Sur mobile : le CTA collant est-il visible, accessible au pouce et ne couvre-t-il pas le contenu ?
  8. Y a-t-il quelque chose qui ressemble à une page IA par défaut — dégradé, grille d'icônes-cartes, badges pastilles, blobs flous ?

Vérifications spécifiques aux mobiles

Les visiteurs d'entreprise locale arrivent depuis Instagram, Google Maps, TikTok, les publicités et les liens de messagerie. Le mobile est la surface principale, pas une réflexion après coup.

  • pas de défilement horizontal à 375 ;
  • le texte du héros n'est pas surdimensionné — il ne doit pas manger tout le premier écran ;
  • les cibles tactiles sont suffisamment grandes, rien de minuscule ;
  • la navigation est accessible et fermable ;
  • les images sont recadrées pour le portrait, non comprimées à partir d'un recadrage paysage de bureau ;
  • le CTA collant est présent et raffiné.

Discipline de boucle

  • Corrigez les résultats, puis recapturez. Ne corrigez pas à l'aveugle.
  • Arrêtez-vous lorsqu'un balayage complet ne produit aucun résultat majeur, pas lorsque la liste devient ennuyeuse.
  • Si le même résultat revient après une correction, le problème se trouve dans le bloc, pas dans la page — corrigez-le dans la bibliothèque de blocs.
  • Rapportez honnêtement : si un point de rupture a encore un problème ouvert, dites-le.

Individual skills in this repo

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

Skills associés