CommunityCodierung & Entwicklunggithub.com

visuelle-QA

Verbindliche visuelle Qualitätssicherung per Screenshot für jede signifikante UI-Änderung – Website ausführen, Breakpoints mit Playwright aufnehmen, Screenshots bewerten, korrigieren, wiederholen. Nach dem Bauen oder Umgestalten einer Seite oder Sektion und vor der Meldung als erledigt einsetzen. Für Designbewertung premium-frontend nutzen; für Conversion-Audit conversion-optimization.

Was ist visuelle-QA?

Visuelle-QA ist eine skill für KI-Agenten, die sicherstellt, dass UI-Änderungen nicht nur funktional korrekt, sondern auch optisch makellos sind. Sie erzwingt eine systematische Screenshot-Schleife: Nach jeder größeren Änderung startet der Agent die lokale Entwicklungsumgebung, durchläuft festgelegte Breakpoints (375px, 390px, 768px, 1440px, 1920px) mit Playwright und erstellt vollständige Seiten-Screenshots. Jeder Screenshot wird auf ein umfassendes Kriterien geprüft – darunter gebrochene Layouts, schwache Hierarchie, inkonsistente Abstände, problematischer Textumbruch, unzureichende CTA-Hervorhebung und KI-typische Designmuster. Erkannte Mängel werden behoben, die Screenshots erneut erstellt und wieder bewertet, bis alle Breakpoints makellos sind. Die Skill ist für den Einsatz in Claude Code, Cursor und Codex konzipiert und ergänzt premium-frontend (Designbewertung) und conversion-optimization (Conversion-Audit). Sie legt besonderen Wert auf die mobile Ansicht, die bei lokalen Geschäftskunden die primäre Oberfläche ist, und erfordert ehrliche Berichterstattung auch bei offenen Problemen.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht visuelle-QA?

Gültiges JSX ist kein Beleg für gutes Design. Melden Sie UI-Arbeit niemals als erledigt, ohne sie angesehen zu haben.

Kern

Website lokal ausführen.

Prüfen:
375px
390px
768px
1440px
1920px

Screenshots erstellen.

Jeden Screenshot prüfen auf:

- gebrochenes Layout
- schwache Hierarchie
- übermäßiger Weißraum
- unzureichender Weißraum
- hässlicher Zeilenumbruch
- schlechter Bildausschnitt
- uneinheitliche Ränder
- übergroße Typografie
- winzige Typografie
- schwache CTA-Hervorhebung
- Ausrichtungsprobleme
- generische KI-Designmuster

Erkannte Probleme korrigieren.

Wiederholen, bis keine wesentlichen visuellen Probleme mehr vorhanden sind.

So wird es ausgeführt

Starten Sie den Dev-Server, dann:

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

Die Ausgabe landet in qa/<route>/<breite>.png, vollständige Seite, eine Datei pro Breakpoint. Das Skript meldet außerdem horizontalen Overflow und Konsolenfehler pro Breakpoint – beides sind automatische Fehlschläge.

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

Erstmalige Einrichtung:

npm i -D playwright && npx playwright install chromium

Für interaktives Stöbern statt einer vollständigen Durchführung sind die Browser-Werkzeuge im Editor schneller: Seite öffnen, Größe ändern, Barrierefreiheitsbaum lesen, Konsole prüfen.

Lesen eines Screenshots

Gehen Sie Breakpoint für Breakpoint vor. Beantworten Sie für jeden:

  1. Läuft irgendetwas horizontal über?
  2. Gibt es einen offensichtlichen Fokuspunkt oder wandert das Auge umher?
  3. Erzeugen Überschriften einen hässlichen Schusterjungen oder eine letzte Zeile mit nur einem Wort?
  4. Sind die Abstände zwischen Abschnitten dort konsistent, wo sie es sein sollten, und dort bewusst unterschiedlich, wo sie es sein sollten?
  5. Sind Bilder durch ein Gesicht, einen Teller oder ein Bett beschnitten?
  6. Ist der primäre CTA das hervorstechendste Element in seinem Bildschirmbereich?
  7. Auf Mobilgeräten: Ist der Sticky-CTA sichtbar, mit dem Daumen erreichbar und verdeckt er keine Inhalte?
  8. Sieht irgendetwas nach einer Standard-KI-Seite aus – Verlauf, Icon-Karten-Raster, Pillen-Badges, unscharfe Blobs?

Mobilgeräte-spezifische Prüfungen

Besucher lokaler Unternehmen kommen von Instagram, Google Maps, TikTok, Anzeigen und Messenger-Links. Mobilgeräte sind die primäre Oberfläche, kein nachträglicher Einfall.

  • Kein horizontaler Scroll bei 375;
  • Hero-Text nicht übergroß – er darf nicht den gesamten ersten Bildschirm einnehmen;
  • Tippziele ausreichend groß, nichts winzig;
  • Navigation erreichbar und schließbar;
  • Bilder für Hochformat beschnitten, nicht aus einem Landschafts-Desktop-Zuschnitt gequetscht;
  • Sticky-CTA vorhanden und verfeinert.

Schleifen-Disziplin

  • Korrigieren Sie die Befunde, dann machen Sie einen neuen Screenshot. Korrigieren Sie nicht blind.
  • Hören Sie auf, wenn eine vollständige Durchführung keine wesentlichen Befunde mehr liefert, nicht wenn die Liste langweilig wird.
  • Wenn derselbe Befund nach einer Korrektur erneut auftritt, liegt das Problem im Block, nicht auf der Seite – korrigieren Sie es in der Block-Bibliothek.
  • Berichten Sie ehrlich: Wenn ein Breakpoint noch ein offenes Problem hat, sagen Sie es.

Individual skills in this repo

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

Verwandte Skills