Communitygithub.com

babaketee/frontend-design-review

Überprüfe und erstelle unverwechselbare, produktionsreife Frontend-Oberflächen mit hoher Designqualität und Einhaltung des Designsystems. Bewertung anhand von drei Säulen: Reibungsloser Einblick zur Aktion, hochwertige Handwerkskunst und vertrauenswürdiges Bauen.

Was ist frontend-design-review?

Dieses Skill ermöglicht es, UI-Implementierungen entweder gründlich zu überprüfen oder von Grund auf kreative, produktionstaugliche Frontends zu erstellen, die sich von generischer „KI-Ästhetik“ abheben. Es arbeitet in zwei Modi: **Design-Review** evaluiert bestehende Interfaces auf Konformität mit einem Designsystem (z. B. Storybook, Figma), Zugänglichkeit (WCAG A/AA) und Codequalität; **Creative Frontend Design** erzeugt eigenständige, markante Oberflächen, die auf einen bestimmten ästhetischen Richtwert (z. B. minimalistisch, brutalistisch, verspielt) festgelegt und präzise umgesetzt werden. Das Skill bewertet anhand dreier Qualitätssäulen: reibungslose Nutzerführung (≤3 Interaktionen für Aufgaben), handwerkliche Qualität (kohärente Typografie, Farben, Motion) und Vertrauenswürdigkeit (Kennzeichnung von KI-Inhalten, klare Fehlermeldungen). Es ist optimiert für PR-Reviews, Design-Reviews, Barrierefreiheitsaudits, Komponenten-Reviews und die Erstellung memorabler UIs, aber nicht für Backend- oder Infrastrukturarbeit geeignet. Die Ergebnisse werden in einem strukturierten Output-Format (inkl. Bewertung, Priorisierung und Empfehlungen) ausgegeben.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/babaketee/frontend-design-review/tree/HEAD/.github/skills/frontend-design-review

In Ihrer bevorzugten KI fragen

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

Dokumentation

Frontend Design-Review

Überprüfe UI-Implementierungen anhand von Designqualitätsstandards und deinem Designsystem ODER erstelle von Grund auf unverwechselbare, produktionsreife Frontend-Oberflächen.

Zwei Modi

Modus 1: Design-Review

Bewerte bestehende UI auf Designsystem-Konformität, drei Qualitätssäulen (Reibungslosigkeit, Handwerkskunst, Vertrauenswürdigkeit), Barrierefreiheit und Codequalität.

Modus 2: Kreatives Frontend-Design

Erstelle unverwechselbare Oberflächen, die generische „KI-Schrott“-Ästhetik vermeiden, eine klare konzeptionelle Richtung haben und präzise umgesetzt werden.


Kreatives Frontend-Design

Lege vor dem Codieren eine ästhetische Richtung fest:

  • Zweck: Welches Problem löst dies? Wer nutzt es?
  • Ton: Minimalistisch, maximalistisch, retro-futuristisch, organisch, luxuriös, verspielt, editorial, brutalistisch, Art déco, sanft/pastellig, industriell usw.
  • Einschränkungen: Framework, Leistung, Barrierefreiheitsanforderungen.
  • Abgrenzung: Was macht dies unverwechselbar und kontextgerecht?

Richtlinien für Ästhetik

  • Typografie: Herausragende Schriften, die die Ästhetik heben. Kombiniere eine Auszeichnungsschrift mit einer eleganten Fließtextschrift. Vermeide Inter, Roboto, Arial, Space Grotesk.
  • Farbe & Thema: Kohärente Palette mit CSS-Variablen. Dominante Farben + scharfe Akzente > zurückhaltende, gleichmäßig verteilte Paletten.
  • Bewegung: Bevorzugt CSS-only. Ein gut orchestrierter Seitenaufbau mit gestaffelten Einblendungen > verstreute Mikrointeraktionen.
  • Räumliche Komposition: Asymmetrie, Überlappungen, diagonaler Fluss, rasterbrechende Elemente, großzügiger Negativraum ODER kontrollierte Dichte.
  • Hintergründe: Verlaufsnetze, Rauschtexturen, geometrische Muster, geschichtete Transparenzen, dramatische Schatten, Körnungsoverlays.

VERMEIDE: Überbeanspruchte Schriften, klischeehafte Farbschemata, vorhersehbare Layouts, Einheitsdesign ohne kontextspezifischen Charakter.

Passe die Implementierungskomplexität an die Vision an. Maximalistisch = aufwendiger Code. Minimalistisch = Zurückhaltung und Präzision.


Design-Review

Arbeitsablauf mit dem Designsystem

Vor der Implementierung:

  1. Überprüfe die Komponente in deinem Storybook / deiner Komponentenbibliothek auf API und Nutzung
  2. Verwende den Figma Dev Mode, um genaue Spezifikationen (Abstände, Tokens, Eigenschaften) zu erhalten
  3. Implementiere mit Komponenten des Designsystems + Design-Tokens

Während des Reviews:

  1. Vergleiche die Implementierung mit dem Figma-Design
  2. Stelle sicher, dass Design-Tokens verwendet werden (keine hartcodierten Werte)
  3. Prüfe, ob alle Varianten/Zustände korrekt implementiert sind
  4. Markiere Abweichungen (benötigt Designfreigabe)

Wenn die Komponente nicht existiert:

  1. Prüfe, ob eine vorhandene Komponente angepasst werden kann
  2. Wende dich an das Designteam zur Erstellung einer neuen Komponente
  3. Dokumentiere Ausnahme und Begründung im Code

Review-Prozess

  1. Identifiziere die Benutzeraufgabe
  2. Überprüfe das Designsystem auf passende Muster
  3. Bewerte die ästhetische Richtung
  4. Bestimme den Umfang (Komponente, Funktion oder Ablauf)
  5. Bewerte jede Säule
  6. Bewerte und priorisiere Probleme (blockierend/wichtig/geringfügig)
  7. Gib Empfehlungen mit Beispielen aus dem Designsystem

Kernprinzipien

  • Aufgabenerfüllung: Minimale Klicks. Jeder Bildschirm beantwortet „Was kann ich tun?“ und „Was passiert als nächstes?“
  • Aktionshierarchie: 1–2 primäre Aktionen pro Ansicht. Progressive Offenlegung für sekundäre Aktionen.
  • Onboarding: Erkläre Funktionen bei der Einführung. Intelligente Standardeinstellungen vor Konfiguration.
  • Navigation: Klare Ein-/Ausstiegspunkte. Zurück/Abbrechen immer verfügbar. Breadcrumbs für tiefe Abläufe.

Qualitätssäulen

1. Reibungsloser Einblick zur Aktion

Bewerte: Ist die Aufgabe in ≤3 Interaktionen erledigbar? Ist die primäre Aktion offensichtlich und einzigartig?

Alarmzeichen: Übermäßige Klicks, mehrere konkurrierende primäre Buttons, vergrabene Aktionen, Sackgassen.

2. Qualität ist Handwerkskunst

Bewerte:

  • Designsystem-Konformität: Entspricht Figma-Spezifikationen, verwendet Design-Tokens
  • Ästhetische Richtung: Unverwechselbare Typografie, kohärente Farben, absichtsvolle Bewegung
  • Barrierefreiheit: Mindestens Stufe C (WCAG 2.1 A), ideal Stufe B (WCAG 2.1 AA)

Alarmzeichen: Generische KI-Ästhetik, hartcodierte Werte, Implementierung entspricht nicht Figma, defekter Reflow, fehlende Fokus-Indikatoren.

3. Vertrauenswürdiges Bauen

Bewerte:

  • KI-Transparenz: Haftungsausschluss bei KI-generierten Inhalten
  • Fehlertransparenz: Umsetzbare Fehlermeldungen

Alarmzeichen: Fehlende KI-Haftungsausschlüsse, undurchsichtige Fehler ohne Anleitung.


Review-Ausgabeformat

Siehe references/review-output-format.md für die vollständige Review-Vorlage.

Review-Typ-Modifikatoren

Siehe references/review-type-modifiers.md für kontextspezifische Review-Schwerpunkte (PR, Kreativ, Design, Barrierefreiheit).

Kurzcheckliste

Siehe references/quick-checklist.md für die Vorabnahme-Checkliste, die Designsystem-Konformität, ästhetische Qualität, Reibungslosigkeit, Handwerkskunst und vertrauenswürdiges Bauen abdeckt.

Musterbeispiele

Siehe references/pattern-examples.md für gute/schlechte Beispiele kreativer Frontend- und Designsystem-Reviews.


Danksagungen

Kreative Frontend-Prinzipien inspiriert von Anthropics Frontend-Design-Skill. Design-Review-Prinzipien und Qualitätssäulen-Rahmenwerk erstellt von @Quirinevwm.

Verwandte Skills