Communitygithub.com

UI/UX-Design

Entwirf, implementiere, überprüfe und kritisiere Oberflächen (Web-Apps, SaaS B2B, Dashboards, Formulare, Tabellen, mobil) mit Kriterien der Benutzerfreundlichkeit und überprüfbarem visuellem Design – Nielsen-Heuristiken, UX-Gesetze (Yablonski), Refactoring UI, benutzerzentriertes Design (Lowdermilk, ISO 9241), WCAG 2.2 AA und evidenzbasierte Muster (NN/g, GOV.UK, Baymard).

Was ist UX-Design?

Dieses Skill ist ein umfassender Leitfaden für UI/UX-Design, der sich an Entwickler und Designer richtet, die an Web-Apps, SaaS B2B, Dashboards, Formularen, Tabellen und mobilen Schnittstellen arbeiten. Es destilliert Erkenntnisse aus den Büchern von Lowdermilk, Yablonski und Wathan/Schoger sowie aus NN/g, WCAG 2.2 und öffentlichen Designsystemen. Die Skill hilft dabei, Schnittstellen zu entwerfen, zu implementieren, zu überprüfen und zu kritisieren, indem sie eine hierarchische Entscheidungsstruktur bietet: Projektrichtlinien und Designsysteme haben Vorrang, gefolgt von Barrierefreiheit (WCAG 2.2 AA), evidenzbasierten Mustern und taktischen Ratschlägen aus Refactoring UI. Sie betont die Bedeutung der Anforderungsanalyse vor dem Design, die Verwendung von Nielsen-Heuristiken und UX-Gesetzen, visuelle Designdetails (z. B. Abstandsskalen, Typografie, Farbsysteme) und Barrierefreiheit als nicht verhandelbares Minimum. Die Skill wird typischerweise in Tools wie Claude Code, Cursor oder Codex verwendet und bietet konkrete Checklisten und Arbeitsabläufe für verschiedene Szenarien, wie die Implementierung von UI in Code, die Überprüfung von Bildschirmen oder die Entscheidung zwischen Designalternativen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JVISERASS/ui-ux-design/tree/main

In Ihrer bevorzugten KI fragen

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

Dokumentation

UI/UX Design

Persönliches Skill. Destilliert mit eigenen Worten drei Bücher (Lowdermilk, User-Centered Design; Yablonski, Laws of UX; Wathan und Schoger, Refactoring UI) plus NN/g, WCAG 2.2 und öffentliche Designsysteme. Die Details, mit Quellen und als nicht verifiziert markiert, befinden sich in references/. Diese Datei ist das, was immer im Kopf sein sollte.

0. Wer entscheidet

Wenn zwei Ratschläge kollidieren, gewinnt der höherrangige:

  1. Das Designsystem und die Projektanweisungen (CLAUDE.md, Tokens, Primitive, Markenrichtlinie). Wenn das Projekt sagt „Radius 0 und keine Schatten“, werden keine Schatten vorgeschlagen, auch wenn Refactoring UI sie empfiehlt: Die Tiefe wird mit dem erreicht, was das System erlaubt (Strich, Hintergrund, Abstand). Vor dem Erfinden neuer Tokens und Komponenten die vorhandenen lesen.
  2. Harte Regeln: Barrierefreiheit WCAG 2.2 AA und den Benutzer nicht täuschen. Wenn das Projektsystem Kontrast oder Fokus verletzt, wird dies mit dem WCAG-Kriterium und einer Alternative innerhalb des Systems angezeigt.
  3. Evidenz: Studien und Leitfäden mit Daten (NN/g, Baymard, GOV.UK, ISO-Normen).
  4. Handwerk: Die taktischen Ratschläge von Refactoring UI und ähnlichen. Sie sind standardmäßig gut, keine Gesetze.

Immer sagen, zu welcher Ebene eine Empfehlung gehört: „WCAG 1.4.3 (obligatorisch)“ wiegt nicht so schwer wie „sieht normalerweise so besser aus“. AI Summary (target language): Dieses Skill ist ein umfassender Leitfaden für UI/UX-Design, der sich an Entwickler und Designer richtet, die an Web-Apps, SaaS B2B, Dashboards, Formularen, Tabellen und mobilen Schnittstellen arbeiten. Es destilliert Erkenntnisse aus den Büchern von Lowdermilk, Yablonski und Wathan/Schoger sowie aus NN/g, WCAG 2.2 und öffentlichen Designsystemen. Die Skill hilft dabei, Schnittstellen zu entwerfen, zu implementieren, zu überprüfen und zu kritisieren, indem sie eine hierarchische Entscheidungsstruktur bietet: Projektrichtlinien und Designsysteme haben Vorrang, gefolgt von Barrierefreiheit (WCAG 2.2 AA), evidenzbasierten Mustern und taktischen Ratschlägen aus Refactoring UI. Sie betont die Bedeutung der Anforderungsanalyse vor dem Design, die Verwendung von Nielsen-Heuristiken und UX-Gesetzen, visuelle Designdetails (z. B. Abstandsskalen, Typografie, Farbsysteme) und Barrierefreiheit als nicht verhandelbares Minimum. Die Skill wird typischerweise in Tools wie Claude Code, Cursor oder Codex verwendet und bietet konkrete Checklisten und Arbeitsabläufe für verschiedene Szenarien, wie die Implementierung von UI in Code, die Überprüfung von Bildschirmen oder die Entscheidung zwischen Designalternativen.

1. Bevor du etwas malst: Das Bedürfnis

Anfragen kommen als Lösungen („CSV-Export hinzufügen“, „Hier einen Button setzen“). Dahinter steckt ein Bedürfnis, und die wörtliche Lösung zu entwerfen, führt oft zu mehr Oberfläche und schlechteren Ergebnissen. Deshalb vor dem Design:

  • Die Anfrage umformulieren als: wenn [Situation], möchte [Person] [Ergebnis] erreichen, weil [Grund]. Wenn die Situation oder der Grund nicht ausgefüllt werden kann, nachfragen oder die Annahme deklarieren.
  • Nutzungskontext (ISO 9241-11): Wer, welche Aufgabe, wo und womit (mobil in der Sonne, Desktop mit zwei Bildschirmen, tägliche Nutzung durch Experten oder einmal im Jahr). „Benutzerfreundlich“ gibt es nicht abstrakt: immer für jemanden, für eine Aufgabe, in einem Kontext.
  • Die aktuelle Problemumgehung finden (Excel, WhatsApp, Papier): Sie ist die beste Spezifikation dessen, was benötigt wird.
  • Mindestens eine Alternative anbieten, die dasselbe Bedürfnis mit weniger Oberfläche löst, falls vorhanden.
  • Zuerst den Happy Path, und sofort die Zustände: Laden, leer (erstes Mal / durch Filter / ohne Berechtigungen), Fehler, Erfolg, teilweise. Ein Bildschirm ohne seine Zustände ist nicht entworfen.

Für Interviews, Usability-Tests, Anzahl der Benutzer, Metriken und SUS → references/centrado-en-usuario.md.

2. Struktur und Interaktion (was am meisten wiegt bei der Benutzerfreundlichkeit)

Nielsen-Heuristiken als Checkliste auf einen Blick:

  1. Sichtbarer Status: Das System sagt, was passiert (speichernd, gespeichert, ladend, Fehler).
  2. Sprache des Benutzers, nicht des Datenmodells.
  3. Kontrolle und Freiheit: Rückgängig machen, abbrechen, zurückgehen.
  4. Konsistenz: Gleiches sieht gleich aus und verhält sich gleich, und Konventionen werden respektiert.
  5. Fehlervermeidung: Einschränkungen, gute Standardwerte, verschiedene Formate akzeptieren.
  6. Wiedererkennen statt Erinnern.
  7. Abkürzungen für Experten, ohne Anfänger zu behindern.
  8. Minimalismus: Jedes Element konkurriert mit den anderen.
  9. Fehler, die sagen, was passiert ist und wie man es behebt.
  10. Hilfe im Kontext.

UX-Gesetze, die am häufigsten verwendet werden, mit ihren Grenzen:

GesetzAnwendenVorsicht bei
JakobKonventionelle Muster; beim Wert innovieren, nicht bei der NavigationDie Branchenkonventionen (ERP, CAD) wiegen schwerer als die des allgemeinen Webs
FittsGroße Ziele nahe der Aufmerksamkeit; Senden-Button neben dem letzten FeldDie „unendlichen“ Ecken gelten nur mit der Maus, nicht bei Touch
HickWeniger Optionen bei Eile; die empfohlene hervorheben; progressiv enthüllenGilt nur für die Auswahl zwischen bekannten Optionen; beim Suchen zählt die Organisation (Reihenfolge, Gruppen, Suche)
Miller / ArbeitsgedächtnisGruppieren (Chunking); das System soll sich für den Benutzer erinnernDie „7±2“-Regel begrenzt keine Menüs: Das Sichtbare belastet das Gedächtnis nicht. Die tatsächliche Kapazität liegt bei ~4 Blöcken (Cowan)
TeslerDie Komplexität soll das System absorbieren (Standardwerte, Autovervollständigung, Berechnung)Verstecken ist nicht vereinfachen: Es verschiebt nur die Komplexität
PostelVerschiedene Formate akzeptieren und normalisierenAkzeptieren ist nicht stillschweigend raten: Wenn es mehrdeutig ist, die Interpretation anzeigen oder nachfragen
Peak-EndDen Moment des höchsten Werts und den Abschluss pflegen; negative Spitzen überwachen—
Von RestorffEin einzelnes hervorgehobenes Element pro ZoneWenn alles hervorsticht, sticht nichts hervor, und Hervorgehobenes kann wie eine Anzeige wirken
Reaktionszeiten<0,1 s nichts; ~1 s leichtes Feedback; 2–10 s Skelett oder Spinner; >10 s % + abbrechenDie „400 ms“ von Doherty erscheinen nicht im Originalbericht von 1982; Nielsens 0,1/1/10 s verwenden
Goal-gradientSichtbarer und ehrlicher Fortschritt bei langen ProzessenFalscher Fortschritt ist ein irreführendes Muster

Die 30 Gesetze, die Karte nach Situation (Formulare, Onboarding, Checkout, Tabellen, mobil…) und die schlechten Anwendungen → references/leyes-ux.md.

Muster mit Evidenz (Details und Quellen → references/patrones.md):

  • Formulare: Etikett oben und sichtbar (niemals der Platzhalter als Etikett); eine Spalte; korrekte autocomplete- und inputmode-Werte; Telefonnummer, Datum oder IBAN nicht in mehrere Felder aufteilen; Validierung beim Verlassen des Feldes oder beim Absenden und den Fehler entfernen, sobald korrigiert („früh belohnen, spät bestrafen“); der Fehler neben dem Feld, der sagt, was passiert ist und wie man es behebt, mit den Worten des Etiketts; immer das Geschriebene behalten.
  • Schaltflächen: Verb + Objekt („Rechnung speichern“, nicht „Akzeptieren“); eine primäre Schaltfläche pro Ansicht; deaktivierte Schaltflächen vermeiden, die den Grund nicht erklären (besser klicken lassen und erklären); Doppelklick vermeiden.
  • Destruktiv: Lieber rückgängig machen als bestätigen; nur das Unumkehrbare bestätigen, dabei sagen, was verloren geht, und Schaltflächen mit der Aktion („3 Rechnungen löschen“ / „Behalten“), nicht Ja/Nein.
  • Leerzustände: Sagen, dass es leer ist (und nicht ladend), was hier erscheinen wird und die Schaltfläche zum Starten; Filter und Sortierung ausblenden, solange es nichts gibt.
  • Tabellen: Lesbare Kennung in der ersten Spalte; Zahlen rechtsbündig mit tabular-nums und gleicher Dezimalstellenanzahl; fixierter Kopf; sichtbare Filter mit dem Aktiven im Blick; sichtbare Zeilenaktionen, nicht nur bei Mausüberführung; Alternative zum Ziehen. Mobil: Karten zum Durchsehen von Datensätzen und Tabelle mit fixierter erster Spalte zum Vergleichen.
  • Dashboards: Eine Aufgabe; jede Zahl mit Vergleich, Einheit und Zeitraum; Balken und Linien vor Torten oder Tachometern; Farbe mit Bedeutung, niemals als einziger Hinweis.
  • Navigation: Sichtbar am Desktop (das Hamburger-Menü reduziert die Entdeckbarkeit); mobil, untere Leiste mit 3–5 Zielen mit Icon und Text; Häufiges in erreichbaren Zonen, nichts Kritisches in den oberen Ecken.
  • Microcopy: Das Wichtige in den ersten zwei Wörtern; die Hälfte der Wörter streichen; überfliegbare Untertitel; kurze Sätze im Aktiv; kein „Bitte“, „Ups“ oder „ungültig“.

3. Visuelles Design (Refactoring UI, kurz)

Details mit Werten und CSS/Tailwind → references/diseno-visual.md (§11 ist die Spickzettel).

  • Mit der Funktionalität beginnen, nicht mit dem Layout, und in Graustufen: Wenn die Hierarchie in Grau nicht funktioniert, repariert Farbe sie nicht. Farbe kommt ganz zum Schluss.
  • Systeme vor Werten: Feste Skalen für Abstand, Schriftgröße, Farbe, Schatten und Radius, und Entscheidungen durch Auswahl aus ihnen treffen. Im Code: Tokens; keine willkürlichen Werte (p-[13px]) ohne Grund.
  • Hierarchie mit Gewicht und Farbe vor Größe: 2–3 Texttöne (primär, sekundär, tertiär) und 2 Gewichte (normal und semibold/bold); nichts unter 400. Etwas hervorheben bedeutet oft, das Konkurrierende abzuschwächen.
  • Etiketten sind das letzte Mittel: Selbsterklärende Formate („12 auf Lager“ besser als „Lagerbestand: 12“); wenn ein Etikett nötig ist, sollte es weniger wiegen als der Wert. Abschnittsüberschriften funktionieren oft als kleine Etiketten: Die visuelle Hierarchie muss nicht der der h1…h6 folgen.
  • Abstand: Mit zu viel Luft beginnen und dann reduzieren; nichtlineare Skala (4, 8, 12, 16, 24, 32, 48, 64, 96…), bei der kein Schritt weniger als ~25 % des nächsten beträgt; mehr Abstand zwischen Gruppen als innerhalb einer Gruppe (das Etikett nahe an seinem Feld).
  • Breiten: Nicht auf den gesamten Bildschirm ausdehnen; max-width pro Komponente; Absätze von 45–75 Zeichen; Seitenleiste mit fester Breite und flexiblem Inhalt.
  • Text: Handgefertigte typografische Skala (12/14/16/18/20/24/30/36/48…) in px oder rem, niemals em; Zeilenabstand von ~1,5 im Fließtext und ~1–1,25 in Überschriften; große Überschriften mit etwas engerem Tracking und Großbuchstaben mit weitem Tracking; Basislinienausrichtung beim Mischen von Größen; Text nur in 2–3 Zeilen zentrieren.
  • Farbe: 8–10 Grautöne (leicht getönt) und 5–10 Töne pro Farbe (100–900), vorab definiert, am besten in OKLCH (gleichmäßige wahrgenommene Helligkeit); mehr Chroma an den Enden; niemals grauer Text auf farbigem Hintergrund (einen Ton derselben Farbe verwenden); Badges mit umgekehrtem Kontrast (heller, getönter Hintergrund und dunkler Text desselben Tons); Farbe niemals als einziges Signal.
  • Schaltflächen nach Wichtigkeit, nicht nach Semantik: Primär gefüllt, sekundär mit Umriss oder weichem Hintergrund, tertiär als Link. Destruktive Schaltflächen sind nur dann groß und rot, wenn sie die primäre Aktion sind (der letzte Button im Bestätigungsdialog).
  • Tiefe (wenn das System sie zulässt): Licht von oben; etwa 5 Schatten aus zwei Ebenen; weniger Ränder (durch Abstand, Hintergrund oder Schatten trennen); Akzentrand für Farbe. Ohne Schatten: Unterschiede im Hintergrund und feine Linien.
  • Bilder: Symbole werden nicht skaliert (in eine Form mit Hintergrund einfügen); von Benutzern hochgeladene Bilder in einem festen Container mit object-fit: cover; Text über einem Bild benötigt eine Ebene, die den Kontrast gewährleistet.
  • Dunkelmodus: Die semantischen Tokens neu zuweisen, nicht invertieren; Oberflächen, die mit der Höhe heller werden; weniger gesättigte Akzente.
  • Zahlen: font-variant-numeric: tabular-nums bei allem, was verglichen oder aktualisiert wird.

4. Barrierefreiheit: Das Minimum, das nicht verhandelbar ist

WCAG 2.2 AA ist das Ziel (und was die EN 301 549 V4.1.1 in der EU verlangt). Vollständige Checkliste mit den 55 A/AA-Kriterien, ARIA, Modalen, Live-Regionen und Testrezept → references/accesibilidad.md.

  • Natives HTML vor ARIA (button, a href, label, fieldset, dialog); null klickbare divs.
  • Kontrast: Text ≥ 4,5:1; großer Text (≥ 24 px, oder ≥ 18,66 px fett), Eingaberänder, informierende Symbole und Fokus ≥ 3:1. Messen mit der WCAG 2.x-Formel, nicht mit APCA.
  • Vollständige Tastaturbedienung; sichtbarer Fokus (:focus-visible) und nicht verdeckt durch Kopfzeilen oder feste Leisten (scroll-padding); Modale mit Fokus darin, Esc-Taste und Rückgabe des Fokus beim Schließen.
  • Ziele ≥ 24×24 px CSS als rechtliche Untergrenze; auf 44–48 px bei Touch entwerfen.
  • Alles, was gezogen wird, hat eine Alternative ohne Ziehen (Kanban, Sortieren, Slider).
  • Fehler als Text neben dem Feld, mit aria-invalid und aria-describedby; nichts nur durch Farbe.
  • Asynchrone Zustände mit role="status" ankündigen (oder alert, wenn dringend), wobei die Region vorab montiert ist.
  • Login: Einfügen erlaubt; autocomplete mit username, current-password und one-time-code; keine kognitiven Tests.
  • Keine erneute Abfrage bereits eingegebener Informationen im selben Prozess.
  • Reflow auf 320 px ohne horizontales Scrollen (außer bei Datentabellen); Zoom auf 200 %; prefers-reduced-motion.
  • Ein grünes axe bedeutet nicht barrierefrei: In der GOV.UK-Studie fand das beste Tool etwa 41 % der Barrieren (alle zusammen etwa 71 %), und Deque berechnet, dass axe etwa 57 % der Vorfälle erkennt. Es braucht auch einen Durchlauf mit der Tastatur und einen schnellen Test mit einem Screenreader.

5. Wie man je nach Anfrage arbeitet

UI in Code implementieren oder verbessern

  1. Das Designsystem des Projekts lesen (Tokens, Primitive, bereits vorhandene ähnliche Komponenten) und vor dem Erstellen wiederverwenden.
  2. Das Bedürfnis, den Kontext und die Zustände schreiben (§1).
  3. Zuerst die Funktionalität aufbauen, mit der Hierarchie in Grau; dann Abstand, Typografie und Farbe mit den Tokens.
  4. Die Zustände abdecken: default, hover, focus-visible, active, disabled (mit Grund), loading, leer, Fehler, Erfolg.
  5. Prüfen: Mobilbreite (320–380 px) und Desktop, Tastatur, Kontrast und lange Texte oder extreme Daten (Namen mit 60 Zeichen, Beträge mit 7 Ziffern, Listen mit 0 und 500 Zeilen). Wenn ein Browser verfügbar ist, den echten Bildschirm ansehen: Ein Screenshot zeigt, was der Code nicht zeigt.

Einen Bildschirm, einen Screenshot oder einen PR überprüfen

§2–§4 durchgehen und zurückgeben:

  1. Zusammenfassung in 2–3 Zeilen: Was funktioniert und was das teuerste Problem ist.
  2. Befunde geordnet nach Schweregrad (Nielsen-Skala: 4 katastrophal, vor der Veröffentlichung beheben · 3 schwerwiegend · 2 geringfügig · 1 kosmetisch). Bei jedem: wo, gegen welches Prinzip verstoßen (Heuristik, Gesetz oder WCAG-Kriterium mit Nummer), wen es betrifft und wie, und die konkrete Behebung (Wert, Komponente, Copy), wobei das Obligatorische vom Geschmack getrennt wird. Deklarieren, dass der Schweregrad der eines einzelnen Bewerters ist.
  3. Schnelle Behebungen: maximal 5, die mit der größten Wirkung und dem geringsten Aufwand.
  4. Offene Fragen: Was nur mit Daten oder Benutzern gelöst werden kann.

Zwischen Alternativen entscheiden

Gegen die Hauptaufgabe und den Kontext vergleichen (§1), nicht nach Geschmack. Wenn der Unterschied vom tatsächlichen Verhalten abhängt, dies sagen und den günstigsten Test vorschlagen, der es lösen würde (Test mit 5 Benutzern, A/B, Analytik): references/centrado-en-usuario.md §5.

Ohne Code entwerfen (Flow oder Wireframe)

Das umformulierte Bedürfnis, den Flow des Happy Path mit seinen Zuständen, die Struktur jedes Bildschirms, begründet mit einem Prinzip pro Entscheidung, und was noch mit Benutzern validiert werden muss, liefern.

6. Verhaltensregeln

  • Konkret vor allgemein: „Den sekundären Text von gray-400 auf gray-600 von Tailwind v3 erhöhen (2,5:1 → 7,6:1 auf Weiß; WCAG 1.4.3 verlangt 4,5:1)“ anstelle von „den Kontrast verbessern“.
  • Eine Zeile Begründung pro Empfehlung, mit der Quelle.
  • Die Laien-Perspektive zuerst: Für jemanden, der diese Seite zum ersten Mal sieht, sind sichtbare Statusmeldungen, klare Fehlerbehebungen und offensichtliche Aktionen wichtiger als Pixel-Perfektion.
  • Lücken benennen, nicht füllen: Was nicht getestet oder belegt ist, als solches kennzeichnen und nicht als gesichert ausgeben. Im Zweifel die unsicherere, aber überprüfbare Empfehlung geben („das wissen wir nicht, aber testen wir es“).

7. Was diese Datei nicht ist

Diese Datei ist kein Ziel, sondern ein Werkzeug. Sie zu befolgen, ohne den Kontext zu prüfen, ist so, als würde man ein Rezept blind befolgen, ohne die Zutaten zu riechen. Jeder Bildschirm, jedes Projekt, jeder Benutzer hat andere Prioritäten. Die Prinzipien hier sind ein Startpunkt, keine Checkliste, die man abhaken muss.


Referenzen und ausführliche Anhänge → Verzeichnis references/

Verwandte Skills