Communitygithub.com

better-ui

Verfeinert Oberflächen, Symbole und Bewegungen mit exakten Werten für Rahmenradius, optische Ausrichtung, Schatten, Symbolzustände und Animationen.

Was ist better-ui?

better-ui ist eine Skill-Definition für KI-Agenten, die sich auf die visuelle Verfeinerung von Benutzeroberflächen spezialisiert. Sie liefert präzise, feste Werte – keine Bereiche – für Details wie Rahmenradius, Schatten, Zoomeffekte bei Interaktionen und Symbolübergänge. Der Skill grenzt seine Zuständigkeit klar von anderen Skills ab (z.B. better-typography, better-accessibility, better-layout) und stellt sicher, dass das visuelle Polieren niemals eine defekte Interaktion überschreibt. Der Skill ist besonders nützlich für Entwickler, die mit Tailwind CSS, Motion-Bibliotheken oder Vanilla-CSS arbeiten, und kann auf Plattformen wie Claude Code, Cursor oder anderen KI-gestützten Coding-Umgebungen angewendet werden. Er operiert auf dem Prinzip, dass Interaktionen zuerst funktional einwandfrei sein müssen, bevor visuelle Verfeinerungen angewendet werden. Ein wesentlicher Aspekt ist die barrierefreie Umsetzung von Bewegung, z.B. durch die bevorzugte Einstellung für reduzierte Bewegung (`prefers-reduced-motion`), bei der alle Bewegungen, Skalierungen und Unschärfen durch einen Opazitäts-Wechsel ersetzt werden. Zusätzlich enthält better-ui eine Reihe von genauen Vorgaben, darunter das 0.96-Skalierungsverhalten beim Drücken einer Taste, die sofortige Reaktion bei hochfrequenten Interaktionen (Tastaturanschläge, Zeilen-Hover), das Staffeln von einleitenden Animationen in 100-ms-Abständen und die Verwendung von `will-change` nur bei Bedarf. Der Skill beinhaltet auch eine Checkliste zur Qualitätssicherung, die Entwicklern hilft, schnelle Überprüfungen durchzuführen und eine Berichtsstruktur für die Dokumentation von Befunden anzubieten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Atou4/skillsmith/tree/HEAD/skills/ui-ux/better-ui

In Ihrer bevorzugten KI fragen

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

Dokumentation

UI-Politur

Dieser Skill enthält die visuelle Politur für Oberflächen, Symbole und Bewegungen, mit dem genauen Wert jedes Details. Er wird angewendet, sobald die zugrunde liegende Interaktion einwandfrei ist, und ein Politurbefund hat nie Vorrang vor einer defekten Interaktion.

Exakte Werte, optionale Politur

Die Werte unten sind exakt, keine Bereiche, die angenähert werden. cubic-bezier(0.2, 0, 0, 1) ist nicht cubic-bezier(0.4, 0, 0.2, 1), und 0.96 ist nicht 0.95. Die optischen Korrekturen und der konzentrische Auffüllungs-Grenzwert sind die Ausnahmen. Sie sind Ausgangspunkte, die nach Augenmaß beurteilt werden.

Behalte die Komponentenbibliothek, Tokens und Dichte des Projekts bei und passe die Bewegungssprache des Projekts an, wo immer keine Regel hier einen Wert vorgibt. Eine bewusste und konsistente Projektkonvention, wie z.B. ein Stil ohne Schatten, ist eine Präferenz und kein Befund. Das gleiche Detail auf zwei Arten im Projekt umgesetzt ist ein Befund.

Textumbruch, Schriftdarstellung, tabellarische Zahlen und Textabstände gehören zu better-typography. Trefferflächen, Tastaturunterstützung, ARIA und die Anforderung an reduzierte Bewegung gehören zu better-accessibility. Gruppierung, Abschnittsabstände, Haltepunkte und räumliches RTL gehören zu better-layout, mit Ausnahme der Spiegelung von Richtungssymbolen. Farb-Tokens und Kontrastmessung gehören zu better-colors.

Äußerer Radius gleich innerem Radius plus Auffüllung

Wo verschachtelte Oberflächen einen sichtbaren, gleichmäßigen Innenabstand teilen, ist der äußere Radius der innere Radius plus die Auffüllung plus jegliche Rahmenbreite. Ab 24px Auffüllung oder wo die Auffüllung bewusst asymmetrisch ist, behandle die Schichten als separate Oberflächen und behalte den Radius-Token jeder einzelnen bei. Rezepte sind in surfaces.md.

Optisch ausrichten, wo die Geometrie falsch aussieht

Wo die geometrische Zentrierung falsch aussieht, korrigiere nach Augenmaß. Gib einem Button 2px weniger Auffüllung auf seiner Symbolseite, verschiebe ein Play-Dreieck in Richtung seiner Spitze und korrigiere asymmetrische Glyphen im SVG selbst. Rezepte sind in surfaces.md.

Schatten für Höhe, Rahmen für Struktur

Wo ein Rahmen nur dazu da ist, Tiefe zu erzeugen, ersetze ihn durch geschichtete transparente box-shadow-Werte. Behalte Rahmen bei Trennlinien, Separatoren, Tabellenzellen und ausgewählten Zuständen. Behalte sie auch bei Formulareingaben, deren Grenze unter better-accessibility einen Nicht-Text-Kontrast von 3:1 benötigt. Fokusringe gehören ebenfalls zu better-accessibility.

Der forced-colors-Modus entfernt jedes box-shadow. Behalte border: 1px solid transparent unter einem Schattenring, damit dieser Modus immer noch eine Kante zeichnet. Rezepte sind in surfaces.md.

Bilder in reinem Schwarz oder Weiß umranden

Gib Inhaltsbildern einen 1px-Umriss, der um 1px eingerückt ist. Verwende oklch(0 0 0 / 0.1) im hellen Modus und oklch(1 0 0 / 0.1) im dunklen. Verwende niemals eine fast-schwarze Palette, einen getönten Neutralton oder die Akzentfarbe, da die Tönung als farbiger Saum am Bildrand erscheint. Überspringe transparente Grafiken wie Logos und Illustrationen. Das Rezept ist in surfaces.md.

Übergänge, keine Keyframes, für interaktive Zustände

Steuere Änderungen des interaktiven Zustands mit CSS-Übergängen oder den Federn einer Bewegungsbibliothek, die neu ausgerichtet werden, wenn der Benutzer mitten im Flug umkehrt. Keyframes laufen auf einer festen Zeitleiste und können nicht umkehren, reserviere sie daher für Sequenzen, die einmal ablaufen. Siehe animations.md.

Drücken skaliert auf 0.96

Ein gedrückter Button skaliert auf 0.96 über 150ms mit ease-out, und ein deaktivierter skaliert nie. Gib dem Button eine Opt-out-Möglichkeit, wo die Bewegung ablenken würde, über die vorhandene Varianten-API der Komponente oder eine static-Prop. Siehe Rezepte für CSS, Tailwind und Motion.

Hochfrequente Interaktionen reagieren sofort

Tastaturanschläge, Zeilen-Hover und Tab-Wechsel erhalten sofortiges Feedback oder einen Übergang von 150ms oder weniger auf opacity oder background-color. Reserviere ausdrucksstarke Bewegungen für seltene Momente wie das erste Laden einer Ansicht, einen Erfolgszustand oder einen leeren Zustand.

Jede animierte Zustandsänderung hinterlässt auch einen statischen Hinweis in Form einer Farbe, eines Symbols oder einer Beschriftung. Bewegung ist niemals der einzige Feedback-Kanal.

Bewegung hinter die Präferenz für reduzierte Bewegung stellen

better-accessibility besitzt die Anforderung, und kein Rezept hier wird ohne sie ausgeliefert. Führe Bewegung, Skalierung und Unschärfe nur unter prefers-reduced-motion: no-preference aus. Ersetze sie bei reduzierter Bewegung durch einen Opazitäts-Überblendungseffekt, anstatt das Element sofort zu entfernen. Rezepte für CSS, Tailwind und Motion sind in animations.md.

Seltene Eingänge um 100ms staffeln

Wo Sequenz Hierarchie in einem gestaffelten Eingang kommuniziert, teile den Inhalt in semantische Blöcke wie Titel, Beschreibung und Aktionen. Staffle sie 100ms auseinander, jeder mit Opazität, 4px Unschärfe und 12px translateY über 300ms mit ease-out. Staffle niemals Routine-Interaktionen. Siehe enter-exit.md.

Ausgänge sind kürzer und kleiner als Eingänge

Verlasse mit Opazität, 4px Unschärfe und einem festen -12px translateY über 150ms mit ease-out, niemals die gesamte Container-Höhe. Schiebe nur vollständig heraus, wo das Ziel Bedeutung trägt, wie z.B. beim Schließen einer Schublade. Entferne das Element sofort, wo Bewegung keine zusätzlichen Informationen liefert. Siehe enter-exit.md.

Zustandsanimationen beim ersten Rendern überspringen

Setze initial={false} auf ein AnimatePresence, das einen Zustandswechsel umschließt, damit der Standardzustand beim Einfügen nicht animiert wird. Setze es niemals um einen absichtlichen Eingang wie einen gestaffelten Helden. Siehe animations.md.

Kontextuelle Symbole mit exakten Werten überblenden

Wo ein Symbol bei einem seltenen Zustandswechsel wechselt, z.B. von Play zu Pause oder von Kopieren zu Kopiert, überblende es. Skalierung läuft von 0.25 bis 1, Opazität von 0 bis 1 und Unschärfe von 4px bis 0px. Verwende mit einer Bewegungsbibliothek { type: "spring", duration: 0.3, bounce: 0 }, und Bounce ist immer 0. Ohne eine solche Bibliothek behalte beide Symbole im DOM und überblende über 300ms mit cubic-bezier(0.2, 0, 0, 1).

Der Symbolwechsel eines Tabs und die Aktionen, die eine Zeile beim Hover preisgibt, fallen unter Hochfrequente Interaktionen reagieren sofort. Beide Rezepte sind in icon-transitions.md.

Übergänge beim Themenwechsel unterdrücken

Deaktiviere jeden Übergang für den Themenwechsel, erzwinge einen Stil-Flush und stelle die Übergänge nach dem nächsten Frame wieder her. Andernfalls feuern alle Farbübergänge auf einmal und der Wechsel verschmiert. Siehe das Rezept.

Nur das ändern, was sich ändert

Benenne die genauen Eigenschaften, wie in transition-property: scale, opacity, und niemals all. Siehe performance.md.

Die animierte Eigenschaft in will-change benennen

Füge will-change erst hinzu, nachdem du ein Ruckeln im ersten Frame siehst, und benenne die Eigenschaft, die du animierst: scale für scale, transform für transform. Beschränke es auf Transform-Eigenschaften, opacity und filter, und verwende niemals all. Siehe performance.md.

Hover-Effekte nur auf hover-fähigen Zeigern

Setze Hover-only-Stile hinter @media (hover: hover). Auf Touch-Geräten rastet :hover nach einem Tippen ein und wird als hängender Auswahlzustand gelesen. Tailwind 4's hover: Variante kompiliert bereits unter dieser Abfrage, Tailwind 3's nicht. Wo ein Steuerelement seinen eigenen gedrückten Zustand zeichnet, setze -webkit-tap-highlight-color: transparent, damit der standardmäßige graue Blitz ihn nicht verdoppelt.

Scrollen in Overlays begrenzen

Gib scrollbaren Dialogen, Drawern, Menüs und Seitenbereichen overscroll-behavior: contain, damit das Scrollen über ihr Ende hinaus niemals die Seite darunter scrollt.

Symbolstrich an Textgewicht anpassen

Der gerenderte Strich eines Symbols folgt dem Gewicht des Textes daneben, von 1.5px bei 400 bis 2.5px bei 700. Verwende eine Symbolbibliothek pro Oberfläche. Die Tabelle, Größenregeln und Gitterregeln sind in icons.md.

Ein SVG, pro Zustand neu eingefärbt

Icons verwenden currentColor und nehmen Hover-, Ausgewählt- und Deaktiviert-Zustände von CSS-Farbe und Opazität an, niemals von separaten Assets. Umriss ist die Standardvariante, und Füllung markiert den aktiven Zustand. Unter dir="rtl" spiegele nur Symbole, deren Bedeutung der Leserichtung folgt. Siehe icons.md.

Bevor du fertig bist

ErkennungLösung
Mit rounded-* oder border-radius versehenes Elternteil und KindFüge die Auffüllung zum äußeren Radius hinzu
box-shadow: 0 0 0 1px Ring ohne border danebenborder: 1px solid transparent
outline-slate-*, outline-zinc-* oder eine Hex-Umrissfarbe auf imgoutline-black/10 und dark:outline-white/10
transition-all oder transition: allBenenne die sich ändernden Eigenschaften
animation: gesetzt auf :hover, .open oder eine andere umgeschaltete KlasseEin Übergang auf denselben Eigenschaften
active:scale-95, scale-90 oder whileTap unter 0.960.96
:active Skalierung ohne :disabled Ausnahmeenabled:active: oder :not(:disabled):active
bounce: auf etwas anderes als 0 gesetztbounce: 0
opacity: 0 in einer Basisregel, die nur eine animation enthülltVersteckter Zustand im from-Keyframe, animation-fill-mode: both
translate, scale, filter oder motion.* Animation ohne prefers-reduced-motion, motion-safe: oder MotionConfig SchutzSchütze sie und überblende die Opazität bei reduzierter Bewegung
Farbübergänge plus einen Themenwechsel ohne disableTransitionOnChange oder ÜberschreibungDas Rezept zur Unterdrückung des Themenwechsels
will-change: all, oder will-change auf einem Element, das niemals animiertBenenne die animierte Eigenschaft oder lösche sie
fill="#..." oder stroke="#..." in einem Icon-SVGcurrentColor
Plain-CSS :hover oder Tailwind 3 hover: außerhalb von @media (hover: hover)Wickele sie in die Abfrage ein
overflow: auto oder overflow-y-auto auf einem Dialog, Drawer oder Menü ohne overscroll-behavioroverscroll-behavior: contain

Berichterstattung

Schweregrad. HIGH bricht eine Interaktion, wie ein Keyframe-Umschalter, der nicht umkehren kann, oder ein Hover-Zustand, der auf Touch-Geräten hängen bleibt. Zwei Eskalationsauslöser von better-interface landen hier und sind HIGH auf den ersten Blick. Einer ist Bewegung, die prefers-reduced-motion ignoriert, und der andere ist eine Zustandsänderung, die nur durch Bewegung getragen wird. MEDIUM ist eine sichtbare Inkonsistenz in Oberflächen, Symbolen oder Bewegungen. LOW ist isolierte Politur.

Verifizierung. Ohne Browser lese jeden Zustand, den die Komponente definiert, aus dem Code, wie Hover, Gedrückt, Ausgewählt, Laden und Leer, mit seinen Dauern und Easings. Mit einem Browser durchlaufe jeden Zustand und spiele Bewegung bei 10% Geschwindigkeit im Animations-Panel des Browsers ab. Melde jede Überprüfung, die du nicht durchführen konntest, als Not verified.

Format. Gruppiere Befunde nach dem Prinzip, das jedes verletzt, geordnet nach Schweregrad, eine Zeile pro Grundursache, die jeden Ort auflistet, an dem sie erscheint:

SchweregradOrtVorherNachherWarum

Ort ist Pfad/zur/Datei:Zeile. Warum nennt das Prinzip und die Auswirkung auf den Benutzer.

Beende mit Block, wenn ein HIGH übrig bleibt, andernfalls mit Approve, wobei der Rest in der Tabelle als zu erledigende Arbeit bleibt. Gib niemals Approve für eine Abdeckung, die du nicht geprüft hast. Wenn es nichts zu melden gibt, gib an: "Keine umsetzbaren UI-Politur-Befunde" und melde die Verifizierung.

Verwandte Skills