Communitygithub.com

Joncik91/ucai

Verwende dies beim Erstellen von React-Komponenten, Optimieren der Leistung, Analysieren von Bundle-Größen, Einrichten von Projekten, Implementieren von Barrierefreiheit, Überprüfen der Frontend-Codequalität, Durchführen von visuellen Überholungen oder Entwerfen von UI/UX-Systemen.

Was ist ucai?

Diese Fähigkeit (Skill) ist ein umfassender Leitfaden für Frontend-Ingenieure, der sich auf moderne Entwicklungspraktiken, Leistungsoptimierung, Barrierefreiheit und auffälliges UI-Design konzentriert – unabhängig vom verwendeten Framework. Sie ist nützlich für Entwickler, die in Frameworks wie Next.js, Nuxt, SvelteKit, Astro, Remix, Angular oder auf Basis von Vite arbeiten. Der Skill beginnt mit der automatischen Erkennung des zugrunde liegenden Tech-Stacks anhand von Projektdateien (z. B. `next.config.*`, `vite.config.*`) und führt dann zu aktuellen Best Practices, die durch Websuchen ermittelt werden. Ein besonderer Schwerpunkt liegt auf einem „Design-Thinking“-Ansatz: Bevor Code geschrieben wird, wird eine kühne, ästhetische Richtung definiert – von Typografie (Vermeidung von übernutzten Schriften wie Inter oder Roboto) über Farbschemata und Animationen bis hin zu raumgreifenden Layouts und Hintergrunddetails. Darüber hinaus werden universelle Frontend-Prinzipien abgedeckt: Komponentendesign (Einzelverantwortung, Props als API), Performance (Render-Budget, Lazy Loading, Bildoptimierung), Barrierefreiheit (semantisches HTML, Tastaturnavigation, Kontrastverhältnisse), State-Management (lokal vs. global) und Sicherheit (XSS-Prävention, CSP). Eine abschließende Checkliste dient als Review-Richtlinie für Pull Requests, um sicherzustellen, dass alle Aspekte – Ästhetik, Barrierefreiheit, Leistung und Sicherheit – berücksichtigt wurden. Die Fähigkeit ist plattformunabhängig und ein wertvolles Werkzeug für jeden Frontend-Entwickler, der qualitativ hochwertige, durchdachte und nutzerzentrierte Benutzeroberflächen erstellen möchte.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Joncik91/ucai/tree/HEAD/skills/frontend

In Ihrer bevorzugten KI fragen

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

Dokumentation

Frontend-Ingenieur

Frontend-Entwicklungsmuster, Leistungsoptimierung, Barrierefreiheit und unverwechselbares UI-Design für jedes Framework.


Schritt 1: Erkennung des Stacks

Bevor Code geschrieben wird, identifiziere das Framework und die Toolchain anhand von Projekt-Signalen:

Signal-Datei / MusterStack
next.config.*Next.js (React)
nuxt.config.*Nuxt (Vue)
svelte.config.*SvelteKit
astro.config.*Astro
remix.config.* / @remix-run in package.jsonRemix (React)
angular.jsonAngular
vite.config.* + ReactVite + React
vite.config.* + VueVite + Vue
tailwind.config.*Tailwind CSS
styled-components / emotion in package.jsonCSS-in-JS

Prüfe: cat package.json, ls -la, cat vite.config.* – je nachdem, was zutrifft.


Schritt 2: Recherchiere aktuelle Praktiken

Sobald der Stack bekannt ist, suche vor frameworkspezifischen Empfehlungen:

WebSearch: " Komponentenmuster Best Practices 2025" WebSearch: " Leistungsoptimierung 2025" WebSearch: " Bundle-Größenoptimierung 2025" WebSearch: " Barrierefreiheit Best Practices 2025" WebSearch: " Best Practices 2025"


Schritt 3: Design Thinking

Präambel nach den ersten Prinzipien: Bevor du dich für eine Bibliothek, ein Framework oder ein Komponentenmuster entscheidest, frage, ob die Wahl diese spezifische Einschränkung der Benutzeroberfläche löst oder ob es sich um eine Gewohnheit aus größeren Apps handelt. Eine Landing Page ist kein Dashboard; ein Einstellungsfeld ist keine Marketing-Website. Hinterfrage die Anforderung, bevor du das Muster übernimmst; lehne „Wir brauchen X, weil jeder X verwendet“ ab und argumentiere ausgehend vom tatsächlichen Benutzer, Inhalt und Interaktionsmodell.

Beim Erstellen einer Benutzeroberfläche – Komponente, Seite oder Anwendung – lege eine kühne ästhetische Richtung fest, bevor du eine Zeile Code schreibst:

  • Zweck: Welches Problem löst diese Oberfläche? Wer nutzt sie?
  • Ton: Wähle ein Extrem und stehe dazu. Brutal minimalistisch, maximalistisches Chaos, retro-futuristisch, organisch/natürlich, luxuriös/verfeinert, verspielt/spielzeugartig, redaktionell/magazinartig, brutalistisch/roh, Art déco/geometrisch, weich/pastellfarben, industriell/zweckmäßig – lege eine Richtung fest und führe sie präzise aus.
  • Abgrenzung: Was macht dies unvergesslich? Was ist das Eine, woran man sich erinnern wird?
  • Einschränkungen: Framework, Leistungsbudget, Barrierefreiheitsanforderungen.

Das Ziel ist Intentionalität, nicht Intensität. Verfeinerter Minimalismus und kühner Maximalismus funktionieren beide – die generische Mitte funktioniert nicht.

Typografie

Wähle Schriften, die schön, einzigartig und charaktervoll sind. Kombiniere eine unverwechselbare Display-Schrift mit einer raffinierten Körper-Schrift.

  • Vermeide: Inter, Roboto, Arial, Systemschriften, Space Grotesk (übernutzt)
  • Bevorzuge: Unerwartete Entscheidungen, die die Ästhetik aufwerten und sich wie für den Kontext entworfen anfühlen
  • Jede Schriftentscheidung sollte mit einem Grund dokumentiert werden

Farbe und Design

Setze auf eine stimmige Ästhetik. Verwende CSS-Variablen für Konsistenz.

  • Dominante Farben mit starken Akzenten sind besser als zurückhaltende, gleichmäßig verteilte Paletten
  • Definiere Tokens: primär, Oberfläche, Text, Fehler, Rand – streue niemals rohe Hex-Werte
  • Variiere zwischen hellen und dunklen Designs – standardmäßig nicht auf eines festlegen
  • Prüfe Kontrastverhältnisse (4,5:1 für Fließtext, 3:1 für großen Text)

Bewegung

Verwende Animationen für Effekte und Mikrointeraktionen. Bevorzuge CSS-only für HTML; Motion-Bibliothek für React, wenn verfügbar.

  • Ein gut orchestrierter Seitenladevorgang mit gestaffelten Einblendungen sorgt für mehr Freude als verstreute Mikrointeraktionen
  • Verwende Scroll-Trigger und Hover-Zustände, die überraschen
  • Passe die Animationskomplexität an die ästhetische Vision an – maximalistische Designs brauchen aufwändige Bewegungen, verfeinerte Designs brauchen Zurückhaltung

Räumliche Komposition

  • Unerwartete Layouts: Asymmetrie, Überlappungen, diagonaler Fluss, rasterbrechende Elemente
  • Großzügiger Negativraum ODER kontrollierte Dichte – nicht die undefinierte Mitte
  • Visuelle Hierarchie durch Größenkontrast, nicht nur durch Farbe

Hintergründe und visuelle Details

Erzeuge Atmosphäre und Tiefe, anstatt auf Volltonfarben zurückzugreifen:

  • Verlaufsmeshes, Rauschtexturen, geometrische Muster, geschichtete Transparenzen
  • Dramatische Schatten, dekorative Rahmen, Kornüberlagerungen
  • Benutzerdefinierte Cursor, kontextbezogene Effekte, die zur Gesamtästhetik passen

Ästhetische Anti-Patterns

Verwende niemals generische KI-generierte Ästhetik:

  • Übernutzte Schriften: Inter, Roboto, Arial, Space Grotesk, Systemschriften
  • Lila Verläufe auf weißen Hintergründen
  • Vorhersehbare Layouts und standardisierte Komponentenmuster
  • Design ohne kontextspezifischen Charakter
  • Zwei aufeinanderfolgende Generationen, die zu denselben Entscheidungen konvergieren

Schritt 4: Universelle Frontend-Prinzipien

Diese gelten unabhängig vom Framework.

Komponentendesign

  • Einzelverantwortung: eine Komponente, eine Aufgabe – teile auf, wenn eine Komponente zwei verschiedene Dinge tut
  • Props als API: Behandle Komponenten-Props wie eine öffentliche API – dokumentiere, was erforderlich vs. optional ist
  • Co-Location: Halte Styles, Tests und Typen neben der Komponente, zu der sie gehören
  • Komposition vor Vererbung: Bevorzuge die Übergabe von children/slots gegenüber der Erweiterung von Basis-Komponenten
  • Controlled vs. uncontrolled: Sei absichtlich – controlled für Formulare, die Validierung benötigen, uncontrolled für einfache Eingaben

Leistung

  • Render-Budget: Komponenten sollten in unter 16ms für 60fps rendern; profiliere vor der Optimierung
  • Lazy Loading: Code-Splitting an Routengrenzen; verschiebe Komponenten unterhalb des Bildschirmrandes
  • Bildoptimierung: Verwende die Framework-Bildkomponente oder <picture> + srcset; serviere niemals das 2-fache der Anzeigegröße
  • Memoization: Füge nur hinzu, wenn das Profiling ein Problem zeigt – vorzeitige Memoization erhöht die Komplexität ohne Nutzen
  • Bundle-Analyse: Überprüfe regelmäßig die Bundle-Größe; markiere Abhängigkeiten über 50kb, die ersetzt oder nachgeladen werden können

Barrierefreiheit (a11y)

  • Semantisches HTML: Verwende das richtige Element (<button>, nicht <div onClick>, <nav>, nicht <div class="nav">)
  • Fokus-Management: Benutzerdefinierte Modals/Drawers/Dropdowns müssen den Fokus einfangen und beim Schließen wiederherstellen
  • ARIA: Verwende ARIA nur, um Semantik zu erweitern, nicht zu ersetzen; bevorzuge native Elemente
  • Farbkontrast: 4,5:1 für Fließtext, 3:1 für großen Text (WCAG AA Minimum)
  • Tastaturnavigation: Jedes interaktive Element muss per Tastatur erreichbar und bedienbar sein
  • Screenreader-Tests: Teste mit NVDA+Firefox oder VoiceOver+Safari vor der Veröffentlichung

State-Management

  • Lokalität zuerst: Platziere State neben der Komponente, die ihn besitzt; hebe ihn nur bei Bedarf an
  • Server-State vs. Client-State: Verwende eine Datenabruf-Bibliothek für Server-State (TanStack Query, SWR, Apollo) – speichere ihn nicht im globalen Store
  • Abgeleiteter State: Berechne aus der Quelle der Wahrheit – synchronisiere nicht zwei State-Stücke
  • Globaler Store: Nur für wirklich übergreifende Zustände (Auth-Benutzer, Theme, Feature Flags)

Formulare

  • Validierung: Validiere bei Verlassen des Feldes (blur) für UX, bei Absenden (submit) für Korrektheit; zeige Fehler inline an
  • Barrierefreiheit: Jede Eingabe hat ein <label>; Fehlermeldungen werden über aria-describedby referenziert
  • Ladezustände: Deaktiviere das Absenden während asynchroner Vorgänge; zeige einen Spinner oder Fortschritt an
  • Optimistic UI: Wende die Mutation lokal an, mache sie bei Fehler rückgängig

Sicherheit

  • XSS: Setze niemals innerHTML/dangerouslySetInnerHTML aus Benutzereingaben; bereinige, wenn unvermeidbar
  • CSP: Content-Security-Policy-Header; vermeide unsafe-inline
  • Sensible Daten: Protokolliere niemals Tokens, Passwörter oder PII in der Konsole
  • Drittanbieter-Skripte: Prüfe vor dem Hinzufügen; jedes Skript ist ein Lieferkettenrisiko
  • Abhängigkeitsprüfung: Führe regelmäßig npm audit durch; halte Abhängigkeiten aktuell

Review-Checkliste

Vor jedem Frontend-PR:

  • Ästhetische Richtung wurde vor dem Schreiben von Code ausgewählt und dokumentiert
  • Schriftauswahl ist unverwechselbar und kontextgerecht (nicht Inter/Roboto/Arial/Space Grotesk)
  • Farb-Tokens definiert; Kontrastverhältnisse überprüft (WCAG AA)
  • Alle Komponenten-Zustände behandelt – Standard, Hover, Fokus, deaktiviert, laden, Fehler, leer
  • Komponenten haben eine einzige, klare Verantwortung
  • Kein dangerouslySetInnerHTML aus ungeprüften Eingaben
  • Jedes interaktive Element ist per Tastatur erreichbar
  • Jede Eingabe hat ein zugehöriges <label>
  • Bilder haben aussagekräftigen alt-Text (oder alt="" wenn dekorativ)
  • Bundle-Auswirkung für neue Abhängigkeiten bewertet
  • Kein console.log von Tokens oder PII
  • Responsive auf mobilen, Tablet- und Desktop-Breakpoints

Verwandte Skills