Communitygithub.com

check-user-experience

Prüft die UI eines Projekts gegen alle 30 Laws of UX (lawsofux.com) und meldet Probleme mit Gesetz, Ort, Schweregrad und konkreten Lösungsvorschlägen.

Was ist check-user-experience?

Dieses Skill führt eine umfassende Prüfung der Benutzeroberfläche eines Projekts anhand aller 30 Gesetze der Benutzererfahrung (Laws of UX) durch. Es erstellt einen priorisierten Bericht mit echten Problemen und konkreten Lösungen. Das Skill erkennt automatisch die Technologie-Stack (Web, React, Vue, Svelte, Angular, React Native, Flutter, SwiftUI) und durchsucht den Code nach Screens, Routen, gemeinsamen Komponenten und Design-Tokens. Es kann auch über Live-URLs und Screenshots arbeiten. Nach der Analyse präsentiert es einen Bericht im Format: UX Audit – <App/Screen>, mit einer Bewertung der bestandenen Gesetze (0-30) und einer Liste von Funden, gruppiert nach Schweregrad (High, Medium, Low). Jeder Fund enthält das verletzte Gesetz, die genaue Code-Stelle (file:line) oder den UI-Bereich, das beobachtete Problem und einen spezifischen Lösungsvorschlag. Das Skill meldet nur; Änderungen werden nur auf expliziten Wunsch des Benutzers vorgenommen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aswin-haridas/skills/tree/HEAD/skills/check-user-experience

In Ihrer bevorzugten KI fragen

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

Dokumentation

Benutzererfahrung prüfen

Überprüfen Sie eine Oberfläche anhand der Laws of UX und erstellen Sie einen priorisierten Bericht mit echten Problemen und konkreten Lösungen. Melden, nicht beheben, es sei denn, der Benutzer fragt danach.

Arbeitsablauf

1. Die Oberfläche erfassen

  • Codebasis: Erkennen Sie den Stack, suchen Sie dann Screens/Routen, gemeinsame Komponenten (Buttons, Eingaben, Formulare, Navigation, Modale, Listen, Tabellen), Design-Tokens und Lade-/Fehlerzustände. Lesen Sie das eigentliche Markup und die Styles, nicht nur Dateinamen.
  • Live-URL / lokaler Build: Öffnen Sie es im Browser, gehen Sie die Hauptflüsse durch, machen Sie Screenshots in Desktop- und Mobilbreiten, messen Sie nach Möglichkeit Treffziele und Reaktionszeiten.
  • Screenshot: Beurteilen Sie visuell; markieren Sie reine Code-Prüfungen als "nicht verifizierbar".
  • Identifizieren Sie die 3–5 primären Benutzeraufgaben (Anmeldung, Suche, Kaufabwicklung, Erstellen von X). Prüfen Sie diese Flüsse am gründlichsten – das Pareto-Prinzip gilt auch für das Audit.

2. Jedes Gesetz prüfen

Gehen Sie die folgende Tabelle durch. Suchen Sie für jedes Gesetz nach den aufgeführten Signalen. Melden Sie nur konkrete Funde mit einem Ort; blähen Sie den Bericht niemals mit allgemeinen Ratschlägen auf. Wenn ein Gesetz erfüllt ist, wird es in einer Zeile in die Liste "Bestanden" aufgenommen.

3. Bericht (Format unten), dann anbieten, die hohen Punkte zu beheben.

Die Gesetze: worauf zu achten ist und wie zu beheben

Interaktion & Aufwand

GesetzMelden, wennLösungsvorschlag
Fitts'sches Gesetz – die Zeit, ein Ziel zu treffen, hängt von Größe und Entfernung abBerührungsziele < 44×44 pt (iOS) / 48×48 dp (Android) / 24×24 CSS px min (WCAG 2.5.8), idealerweise 44px; reine Symbolschaltflächen mit winziger Polsterung; primäre Aktion weit weg von Auge/Daumen; destruktive und primäre Schaltflächen nebeneinander mit < 8px AbstandPolsterung erhöhen oder ::after { inset:-8px } Treffbereich hinzufügen; primären CTA nahe dem Inhalt platzieren, auf den er wirkt, im Daumenbereich auf Mobilgeräten; destruktive Aktionen trennen
Hicksches Gesetz – Entscheidungszeit wächst mit Anzahl/Komplexität der WahlmöglichkeitenNavigation mit > 7 Elementen der obersten Ebene; Menüs/Auswahlen mit langen unsortierten Listen; viele gleichwertige CTAs auf einem BildschirmGruppieren, progressiv offenlegen ("Mehr"), Suche/Filter zu langen Listen hinzufügen, sinnvolle Voreinstellungen, einen primären CTA
AuswahlüberlastungPreisseiten/Pläne mit > 3–4 Optionen und keiner Empfehlung; Einstellungsdumps; viele Filter auf einmal angezeigtEine empfohlene Option hervorheben, erweiterte Optionen einklappen, Vergleichstabelle
Doherty-Schwelle – Produktivität steigt bei Reaktionszeiten < 400 msKein Lade-/Wartezustand bei asynchronen Aktionen; Schaltflächen deaktivieren sich nicht oder zeigen keinen Fortschritt beim Absenden; Vollbild-Spinner für kleine Ladevorgänge; keine optimistischen Aktualisierungen; blockierende Netzwerkaufrufe bei EingabeSofortiges Feedback < 100 ms, Skelette, optimistische UI, verzögerte Spinner (~300 ms), Suchvorschläge entprellen
Postelsches Gesetz – sei großzügig bei dem, was du akzeptierstStrenge Eingabeformate (Telefon, Daten, Kartennummern, die Leerzeichen/Bindestriche ablehnen); Groß-/Kleinschreibung bei E-Mails; kein Trimmen; Validierungsfehler, die nicht sagen, wie zu beheben; Einfügen blockiertEingabe normalisieren (trimmen, Trennzeichen entfernen), mehrere Formate akzeptieren, inputmode/autocomplete-Attribute, hilfreiche Fehlermeldungen
Teslersches Gesetz – Komplexität kann nicht entfernt, nur verschoben werdenBenutzer muss tun, was das System könnte (bekannte Daten erneut eingeben, Werte berechnen, Zeitzone/Land auswählen, die abgeleitet werden könnten)Automatische Vervollständigung, intelligente Voreinstellungen, Inferenz, letzte Auswahl merken
Paradox des aktiven Benutzers – Benutzer lesen keine HandbücherFunktionen nur über Dokumentation/Tooltips-bei-Hover entdeckbar; lange Einführungstouren vor dem eigentlichen Nutzen; leere Zustände ohne AnleitungInline-Hinweise am Ort der Verwendung, handlungsorientierte leere Zustände, Lernen durch Tun Onboarding
FlowUnnötige Unterbrechungen (Modale, Bestätigungen für reversible Aktionen, erzwungene erneute Authentifizierung); keine Tastaturkürzel für Power-Pfade; verlorener Fokus nach AktionenRückgängig machen statt Bestätigen, Fokus/Scrollposition erhalten, Tastaturunterstützung, Kontextwechsel minimieren

Gedächtnis & Kognition

GesetzMelden, wennLösungsvorschlag
Millersches Gesetz / ChunkingLange ununterbrochene Formulare; lange Zeichenketten roh angezeigt (IDs, Telefon-, Kartennummern unformatiert); Textwüsten; Navigation mit 10+ flachen ElementenFormulare in Gruppen/Schritte unterteilen, Nummern in Blöcken formatieren, Überschriften und kurze Absätze
Kognitive BelastungDichte Bildschirme mit konkurrierenden Elementen; Fachjargon; inkonsistente Terminologie für dasselbe; dekoratives DurcheinanderNicht wesentliche Elemente entfernen, konsistente Beschriftungen, klare Sprache
ArbeitsgedächtnisBenutzer muss sich Informationen aus einem vorherigen Bildschirm merken (Codes, frühere Auswahlen); nur Platzhalter-Beschriftungen, die beim Tippen verschwinden; Vergleiche über Seiten hinwegKontext sichtbar halten (Zusammenfassungen, dauerhafte Beschriftungen, Breadcrumbs), Seitenvergleich
MentalmodellSteuerelemente, die sich anders verhalten als ihr Aussehen (Link als Schaltfläche gestaltet, die navigiert, oder umgekehrt); ungewöhnliche Metaphern; Speichermodell unklar (automatisches Speichern vs. manuell)Erwartungen des Benutzers entsprechen; Systemzustand explizit machen
Jakobsches Gesetz – Benutzer erwarten, dass Ihre Website wie andere funktioniertNicht standardmäßige Platzierung (Logo verlinkt nicht auf Startseite, Warenkorb nicht oben rechts, Suche versteckt); benutzerdefinierte Steuerelemente, die native ersetzen, ohne Gleichwertigkeit; neu erfundene MusterPlattformkonventionen befolgen (HIG / Material / Web-Normen); native Elemente zuerst
Ockhams RasiermesserRedundante Schritte, doppelte Steuerelemente, Funktionen, die niemand für den primären Bildschirm benötigtEntfernen oder in sekundäre Oberflächen verschieben
Pareto-PrinzipPrimäre Aufgaben vergraben, während selten genutzte Funktionen den besten Platz bekommenDie 20 % der Funktionen fördern, die 80 % der Zeit genutzt werden
Parkinsonsches GesetzFormulare/Aufgaben, die länger dauern als nötig; keine automatische Vervollständigung; keine Fortschrittsanzeigen, die Erwartungen setzenAutocomplete, Autofill-Attribute, geschätzte Zeit/Schritte anzeigen
Selektive Aufmerksamkeit / BannerblindheitKritische Informationen wie eine Anzeige gestaltet oder in Bannern/Seitenleisten platziert; wichtige Warnungen gehen unterSchlüsselinformationen inline im Aufgabenpfad platzieren, deutlich, aber nicht wie eine Anzeige
Kognitive VerzerrungDark Patterns: vorausgefüllte Opt-ins, Bestätigungsbeschämung, versteckte Kosten, vorgetäuschte Dringlichkeit, irreführende VoreinstellungenEntfernen; ehrliche Voreinstellungen. Als hoch markieren (ethisches + rechtliches Risiko)

Wahrnehmung (Gestalt)

GesetzMelden, wennLösungsvorschlag
Gesetz der NäheBeschriftungen näher am falschen Eingabefeld; gleicher Abstand zwischen zusammenhanglosen und zusammenhängenden Elementen; Hilfetext weit weg von seinem FeldEngere Abstände innerhalb von Gruppen, größere zwischen Gruppen (Abstandsskala)
Gesetz der ÄhnlichkeitGleich aussehende Elemente, die sich unterschiedlich verhalten (anklickbarer und statischer Text identisch); inkonsistente Schaltflächenstile für dieselbe AktionsstufeEinheitliche visuelle Sprache pro Rolle
Gesetz der gemeinsamen RegionVerwandte Steuerelemente nicht gruppiert; Karten ohne Grenzen, die Inhalt vermischenKarten, Abschnitte, Hintergrundbereiche für Gruppen
Gesetz der einheitlichen VerbundenheitSchritte/verbundene Elemente nicht visuell verknüpftLinien, Verbinder, gemeinsame Container für Schrittindikatoren/Zeitachsen
Gesetz der PrägnanzÜbermäßig komplexe Symbole/Illustrationen, mehrdeutige FormenFormen vereinfachen; erkennbare Symbole mit Beschriftungen
Ästhetik-Usability-EffektVisuelle Inkonsistenz (gemischte Radien, zufällige Farben, nicht ausgerichtetes Raster, inkonsistenter Schriftgrad), die Vertrauen untergräbtAbstände/Schrift/Farbe tokenisieren; an einem Raster ausrichten

Reihenfolge, Motivation & Erinnerung an Erfahrungen

GesetzMelden, wennLösungsvorschlag
Von-Restorff-EffektPrimärer CTA visuell nicht unterscheidbar; alles hervorgehoben, sodass nichts hervorsticht; alleinige Abhängigkeit von FarbeEine hervorgehobene primäre Aktion pro Ansicht; auch Form/Größe/Symbol verwenden (Barrierefreiheit)
Serieller PositionseffektWichtige Navigationselemente in der Mitte langer Listen; wichtigste Informationen in der Seitenmitte vergrabenSchlüsselelemente zuerst und zuletzt platzieren (z. B. Startseite zuerst, Profil/Warenkorb zuletzt in der Tab-Leiste)
Peak-End-RegelSchwache oder fehlende Erfolgszustände (Formularübermittlung endet mit nichts oder einer einfachen Weiterleitung); harte Fehler-Sackgassen; abrupte FlussendenKlare, zufriedenstellende Bestätigung; hilfreiche Wiederherstellung bei Fehlern; letzten Schritt polieren
ZielgradienteneffektMehrschrittige Flüsse ohne Fortschrittsanzeige; Fortschritt, der bei 0 beginntSchrittindikator/Fortschrittsbalken, verbleibende Schritte anzeigen, einen Vorsprung geben
Zeigarnik-EffektUnvollständige Aufgaben vergessen (keine Entwürfe, verlorene Formulardaten bei Navigation, keine Profilvervollständigungs-Hinweise)Entwürfe automatisch speichern, "fortfahren, wo Sie aufgehört haben", Erledigungs-Checklisten

Schweregrad

  • Hoch – blockiert oder verlangsamt eine primäre Aufgabe erheblich, verursacht Fehler/Datenverlust, Barrierefreiheitsproblem oder ein Dark Pattern.
  • Mittel – spürbare Reibung oder Verwirrung auf einem häufigen Pfad.
  • Niedrig – Feinschliff; sekundäre Bildschirme.

Berichtsformat

# UX Audit — <App/Screen>
Scope: <was geprüft wurde> · Methode: Code / Live / Screenshot
Punktzahl: <bestandene Gesetze>/30 · Hoch: n · Mittel: n · Niedrig: n

## Top 3 zuerst zu beheben
1. ...

## Funde
### [Hoch] Fitts'sches Gesetz — Symbolschaltflächen zu klein
Wo: src/components/Toolbar.tsx:42 (auch Header.tsx:18)
Problem: 20×20px Symbolschaltflächen ohne Polsterung; Fehltipps auf Mobilgeräten.
Lösung: `p-3` (44px Ziel) oder eine `::after`-Treffbereichserweiterung hinzufügen.
```(Code-Ausschnitt, falls kurz)```

(…ein Block pro Fund, gruppiert nach Schweregrad, zuerst Hoch…)

## Bestanden
- Jakobsches Gesetz — Standard-Navigation und Logo-Startseiten-Muster.
- ...

## Nicht verifizierbar
- Doherty-Schwelle — benötigt eine laufende App, um Reaktionszeiten zu messen.

Regeln

  • Jeder Fund benötigt ein Gesetz, einen Ort (datei:zeile, URL + Element oder Screenshot-Bereich), das beobachtete Problem und eine spezifische Lösung. Kein Ort → nicht melden.
  • Duplikate zusammenführen: ein Fund pro Hauptursache, alle Orte auflisten.
  • Stil oder Persönlichkeit der App in den Lösungen nicht ändern; die kleinste Änderung vorschlagen, die das Problem löst.
  • Plattformkonventionen (iOS HIG, Material, Web) bei der Beurteilung des Jakobsches Gesetz und der Zielgrößen respektieren.
  • Überschneidungen mit Barrierefreiheit (Kontrast, Fokus, Beschriftungen) sind in Ordnung – unter dem entsprechenden Gesetz notieren, aber dies nicht in ein vollständiges WCAG-Audit verwandeln.
  • Nach dem Bericht fragen, ob die hohen (oder alle) Funde behoben werden sollen. Wenn Bewegungs-/Feedback-Probleme gefunden wurden (Doherty, Peak-End, Zielgradient), erwähnen, dass /animate-this-app diese beheben kann.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills