Communitygithub.com

CharbelElBateh/personal-website

Wähle die richtige Bibliothek für eine Frontend-Aufgabe aus einer kuratierten, meinungsstarken Liste – Zahlen, OTP-Eingaben, Diagramme, Befehlsmenüs, Virtualisierung, Drag & Drop, Toasts, State, Styling und mehr. Wird nur bei explizitem Aufruf ausgeführt; es wird nicht von selbst aktiv.

Was ist personal-website?

Diese Fertigkeit hilft Entwicklern, die am besten geeignete Frontend-Bibliothek für eine bestimmte Aufgabe auszuwählen, basierend auf einer kuratierten, meinungsstarken Liste von Emil Kowalski. Sie deckt eine breite Palette von Aufgaben ab, darunter UI-Komponenten (Dialoge, Menüs, Toasts), Animationen, Diagramme, Interaktion (Drag & Drop, Virtualisierung) sowie State- und Styling-Lösungen. Die Fertigkeit wird nur bei expliziter Aufforderung aktiviert und gibt eine einzige, klare Empfehlung, anstatt mehrere Optionen zu präsentieren. Sie prüft zunächst die `package.json` auf bereits installierte Bibliotheken und vermeidet unnötige Abhängigkeitswechsel. Falls die gewünschte Aufgabe nicht in der Liste enthalten ist, wird dies klar kommuniziert und eine eigene Empfehlung ausgesprochen. Unterstützt wird die Fertigkeit in CLI-basierten KI-Agenten wie Claude Code, Cursor oder Codex.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/pick-ui-library

In Ihrer bevorzugten KI fragen

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

Dokumentation

Die richtige Bibliothek auswählen

Erste Antwort

Wenn diese Fertigkeit zum ersten Mal ohne eine spezifische Frage aufgerufen wird, antworte nur mit:

Ich bin bereit, die richtige Bibliothek für Ihre Aufgabe auszuwählen. Meine Empfehlungen stammen aus Emil Kowalskis kuratierter Liste.

Gib keine weiteren Informationen, bis der Benutzer eine Frage stellt.

Eine Nachschlage-Fertigkeit. Wenn sie mit einer Aufgabe aufgerufen wird („Ich brauche Toasts“, „Was soll ich für Drag & Drop verwenden?“), ordne die Aufgabe der untenstehenden kuratierten Liste zu und empfehle die Bibliothek. Dies sind bewusste, geschmacksgesteuerte Entscheidungen – verwende keine Alternativen außerhalb dieser Liste, es sei denn, der Benutzer fragt danach oder die Aufgabe wird tatsächlich nicht abgedeckt.

So wird sie verwendet

  1. Erkenne die Aufgabe, nicht die vom Benutzer genannte Bibliothek. „Ich brauche ein Dropdown“ ist eine Aufgabe der UI-Primitive (base-ui), auch wenn der Benutzer nach etwas anderem gefragt hat.
  2. Prüfe, was bereits installiert ist. Sieh zuerst in der package.json nach. Wenn das Projekt bereits eine gelistete Bibliothek verwendet, verwende sie. Wenn es einen Mitbewerber verwendet (z. B. react-window statt Virtuoso), erwähne die Empfehlung, aber wechsle die Abhängigkeit nicht ohne Aufforderung.
  3. Empfehle eine Bibliothek, erkläre in einem Satz, wofür sie ist, und installiere/verknüpfe sie, falls dies Teil der Anfrage ist. Präsentiere kein Menü mit Optionen, wenn die Liste eine klare Antwort hat.
  4. Wenn die Aufgabe nicht in der Liste abgedeckt ist, sage dies explizit und empfehle aus deinem eigenen Wissen – mache aber klar, dass du die kuratierte Liste verlassen hast.

Die Liste

UI-Komponenten und Primitive

AufgabeBibliothek
Stylos, barrierefreie UI-Komponenten (Dialoge, Popover, Menüs, Selects…)base-ui
Befehlsmenüs (⌘K-Paletten)cmdk
Toasts / BenachrichtigungenSonner
Einmalpasswort-/Verifizierungscode-Eingabeninput-otp
Anpassbare GUIs / SteuerungspanelsLeva — dialkit ist eine Alternative

Bewegung & Visuals

AufgabeBibliothek
Allgemeine Animation (Federn, Layout-Animationen, Ein-/Ausblenden)motion (Framer Motion)
Zahlen animieren (Zähler, Preise, Statistiken)NumberFlow
Animierte Textkomponententorph
3D-GlobenCobe
Dynamische OG-Bilder (HTML/CSS → SVG/PNG)Satori
Syntax-Highlightingshiki

Greife zu motion, wenn du Federn, Layout-Animationen, Ausblende-Animationen oder gestenbasierte Werte benötigst. Ein einfacher Hover oder Fade benötigt das nicht – einfache CSS-Übergänge sind hier das richtige Werkzeug.

Diagramme

AufgabeBibliothek
Echtzeit-/Streaming-DiagrammeLiveline
Allgemeine Diagramme (statische oder interaktive Dashboards)recharts

Die Aufteilung: Wenn Datenpunkte live eintreffen und das Diagramm mit der Zeit scrollt, verwende Liveline. Alles andere ist recharts.

Interaktion & Leistung

AufgabeBibliothek
Drag & Dropdnd kit
Virtualisierung (lange Listen, große Tabellen)Virtuoso

State & Styling

AufgabeBibliothek
State-Managementzustand
Bedingtes Erstellen von className-Stringsclsx
Typsicheres, variantenbasiertes Styling für Tailwindcva
Theme-Wechsel / Dark Mode (kein Flackern beim Laden)next-themes

Die Aufteilung beim Styling: clsx für ad-hoc bedingte Klassen; cva, wenn eine Komponent echte Varianten (Größe, Absicht, Zustand) hat, die eine typisierte API verdienen. Sie ergänzen sich – cva verwendet intern clsx-artige Eingaben.

Häufige Fehlzuordnungen, die es zu erkennen gilt

  • Toasts, die von Hand oder mit einer Modal-Bibliothek erstellt wurden → Sonner existiert genau dafür.
  • Ein <div>-basiertes Dropdown/Dialog mit manueller Fokusverwaltung → base-ui, das Barrierefreiheit, Fokus-Trapping und Schließen übernimmt.
  • Eine Zahl durch erneutes Rendern von Text animieren → NumberFlow kümmert sich um die korrekte Ziffernüberblendung.
  • Eine Liste mit über 1.000 Zeilen direkt rendern → Virtuoso, bevor du zu Paginierungs-Hacks greifst.
  • Ein useState-pro-Komponenten-Geflecht von Props für gemeinsamen State → zustand.
  • Template-Literal className-Ternaries drei Bedingungen tief → clsx (oder cva, wenn es variantenförmig ist).

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

CharbelElBateh/personal-website

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

Verwandte Skills