Communitygithub.com

UI-Design

Vor dem Entwerfen, Entwickeln oder Überprüfen von UI-Bildschirmen oder -Komponenten laden: Layout, Abstände, Typografie, Farbe, Schatten, Buttons, Formulare, Karten, Icons, Navigation, Bilder, Text, Animationen, Barrierefreiheit, Leer-/Fehlerzustände. Die Regeln, die jeder Bildschirm befolgt, sind hier, mit einer Referenzdatei pro Thema: lies nur die, die deine Aufgabe berührt.

Was ist UI-Design?

Dieser Skill enthält ein Regelwerk für den UI-Design-Prozess, das auf Michael Filipiuks „UI Design Principles“ (2021) basiert. Es definiert verbindliche Richtlinien für Layout, Abstände, Typografie, Farbe, Schatten, Buttons, Formulare, Karten, Icons, Navigation, Bilder, Text, Animationen, Barrierefreiheit und Systemzustände. Der Skill erzwingt eine Prioritätenordnung (Benutzerfreundlichkeit > Barrierefreiheit > Konsistenz > Einfachheit > Aussehen) und stellt sicher, dass das bestehende Designsystem des Repos (z. B. Tailwind-Konfiguration, CSS-Variablen, shadcn/MUI-Theme) Vorrang hat – neue Token oder Komponenten werden nur dort eingeführt, wo Lücken bestehen. Für jedes Thema gibt es eine eigene Referenzdatei im `references/`-Ordner, sodass du nur das lesen musst, was für deine aktuelle Aufgabe relevant ist. Der Skill unterstützt plattformübergreifende Arbeit (Web, iOS, Android) und enthält eine Checkliste zur Qualitätssicherung.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuanEliasJabib02/ui-design-skill/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

UI-Design: Regeln für die Erstellung von Oberflächen

Diese Regeln basieren auf UI Design Principles von Michael Filipiuk (Ausgabe 2021). Diese Datei enthält die Regeln, die für jeden Bildschirm gelten. references/ (neben dieser Datei) enthält die Details, eine Datei pro Thema; lies nur die Dateien, die deine Aufgabe berührt.

Regeln ohne Tag stammen aus dem Buch. (WCAG) kennzeichnet einen Barrierefreiheitsstandard, den das Buch nicht nennt. (convention) kennzeichnet einen allgemeinen Industriestandard, der eine Lücke füllt. (derived) kennzeichnet einen Wert, der mit der Methode des Buches berechnet wurde. 1 pt im Buch = 1 CSS px = 1 iOS pt = 1 Android dp.

Das Designsystem des Repos hat Vorrang

Wenn das Repo bereits Tokens oder ein Theme hat (eine Tailwind-Konfiguration, CSS-Variablen, ein shadcn/MUI-Theme, eine components/ui/-Bibliothek), verwende diese. Dieser Skill füllt nur das, was sie nicht definieren.

  • Führe niemals einen zweiten Satz von Tokens neben den eigenen des Repos ein.
  • Verwende eine vorhandene Komponente wieder, anstatt eine parallele zu bauen.
  • Wenn das Repo selbst eine der folgenden Regeln bricht (einen fehlgeschlagenen Kontrast, einen 32-Pixel-Button), behalte den Wert des Repos bei und melde den Konflikt. Überschreibe ihn nicht stillschweigend.

Priorität bei Regelkonflikten: Benutzerfreundlichkeit > Barrierefreiheit > Konsistenz > Einfachheit > Aussehen.

Schneller Einstieg

  1. Persönlichkeit zuerst: verspielt, neutral oder ernst, basierend auf der Marke und der Zielgruppe (references/personality-and-copy.md). Nie den eigenen Geschmack.
  2. Tokens vor Bildschirmen: Farben, Schriftgrößenskala und Abstandsskala, aus dem Repo oder references/tokens.md. Nichts außerhalb dieser verwenden.
  3. Graustufen zuerst: Hierarchie, Layout und Abstände korrekt einstellen, dann Farbe nur dort hinzufügen, wo sie eine Aufgabe hat.
  4. Komponenten mit jedem Zustand (Standard, Hover, Gedrückt, Fokus, Deaktiviert, Fehler, Erfolg) und jeder Bildschirmzustand (Leer, Ladezustand, Fehler, 404).
  5. Vor dem Melden als erledigt: gehe references/checklist.md für das durch, was du gebaut hast. Wenn du einen Screenshot machen kannst, überprüfe den Screenshot, nicht den Code.

Unverhandelbar

  1. Abstände folgen der Skala. Verwende eine 4-Punkt-Skala auf Mobilgeräten und eine 8-Punkt-Skala im Web. Keine 5, 13 oder 22 Pixel Werte.
  2. Fließtext ist 16–17 px. Gehe für keinen Text unter 10 px und bevorzuge 12 px oder mehr. Verwende niemals eine Light-Schriftstärke für kleinen Text.
  3. Eine Schriftart, standardmäßig eine serifenlose. Verwende etwa 5 Größen.
  4. Verwende niemals #000000 für Text oder Schatten. Verwende ein dunkles getöntes Grau wie #1F1F1F.
  5. Eine Primärfarbe, die nur auf das angewendet wird, was hervorstechen muss. Wenn alles hervorsticht, sticht nichts hervor.
  6. Kontrast: 4,5:1 für Fließtext und 3:1 für großen Text und UI-Elemente (WCAG).
  7. Verwende niemals Farbe allein, um Bedeutung zu vermitteln. Fehler-, Erfolgsmeldungen und Links erhalten auch ein Icon, Text, eine Schriftstärke oder eine Unterstreichung.
  8. Jedes Antipp- oder Klickziel ist mindestens 44×44, auch wenn das sichtbare Symbol kleiner ist.
  9. Buttons sind 40–60 px hoch, mit einem primären Button pro Gruppe. Wenn Buttons paarweise auftreten, steht der primäre rechts. Die Bezeichnung sagt genau, was passiert.
  10. Eingabefelder haben immer ein sichtbares Label. Ein Platzhalter allein ist kein Label. Verwende ein einspaltiges Formular mit Inline-Validierung und lösche niemals die Eingabe des Benutzers.
  11. Schatten sind weich (großer Y-Versatz, große Unschärfe, 5–10 % Deckkraft) und nur für interaktive oder hervorgehobene Elemente.
  12. Icons stammen aus einem Pack, in einem Stil, mit derselben Strichstärke und Rundung. Icons, die nicht allgemein bekannt sind, erhalten ein Label.
  13. Animationen geben Feedback, dauern unter 1000 ms und sind erleichtert (niemals linear).
  14. Kein Lorem Ipsum. Schreibe echte, kurze, menschliche Texte. Fehlermeldungen sagen, wie das Problem behoben wird. Dialoge nennen das Objekt und die Konsequenz.
  15. Gleiches Ding, gleiches Aussehen, gleiches Verhalten auf allen Bildschirmen. Folge den Plattformmustern für das Verhalten.

Welche Referenz zu lesen ist

Die Aufgabe berührtLies
Ein neues Projekt oder Theme, Werte auswählentokens.md (Abstände, Schriftgrößenskala, Farbrollen, Radius, Schatten, Bewegung, Starter-CSS)
Ein Seiten- oder Bildschirmlayout, Raster, Abstände, Hierarchielayout.md
Textstile, Überschriften, Absätzetypography.md
Palette, Dunkelmodus, Schatten, Farbverläufecolor-and-depth.md
Buttons und Handlungsaufforderungenbuttons.md
Formulare, Eingabefelder, Auswahlfelder, Kontrollkästchen, Validierungforms.md
Karten, Listen von Elementencards.md
Iconsicons.md
Tab-Leiste, obere Navigation, Seitenleiste, Linksnavigation.md
Fotos, Illustrationen, Leerzustands- und 404-Grafikenimagery.md
Markengefühl, Button-Beschriftungen, Dialoge, Fehler, Tonpersonality-and-copy.md
Übergänge, Hover, Ladezustand, Feedbackmotion.md
Kontrast, Alternativtexte, Ziele, Bildunterschriftenaccessibility.md
Wiederzuverwendende Komponenten, Zustände, leere/404-Bildschirme, ein Designsystemsystem-and-states.md
Überprüfung eines fertigen Bildschirmschecklist.md

Alle Pfade befinden sich im references/-Ordner dieses Skills.

Verwandte Skills