Communitygithub.com

CharbelElBateh/personal-website

Erstelle mehrere wirklich unterschiedliche Versionen eines von dir beschriebenen UI-Elements, die hinter einem visuellen Auswahltool angezeigt werden, sodass du live durchblättern und die passende Version übernehmen kannst. Das Skill wird nur ausgeführt, wenn es explizit aufgerufen wird; es startet nicht von selbst.

Was ist personal-website?

Dieses Skill („Prototyping Variants“) ist ein divergentes Werkzeug, das einen einzigen Zweck hat: Für ein beschriebenes UI-Element (z. B. einen Toast oder eine Preiskarte) mehrere wirklich unterschiedliche Versionen zu bauen, die über einen visuellen Picker durchgeblättert werden können, sodass der Nutzer den Sieger auswählen kann. Es folgt der Design-Engineering-Philosophie von Emil Kowalski und legt höchsten Wert auf handwerkliche Qualität – korrekte Easing-Kurven, Bewegungen unter 300 ms, ausschließliche Nutzung von `transform` und `opacity`, sowie Berücksichtigung von reduzierter Bewegung. Die Varianten müssen sich entlang benannter Achsen (wie Layout, Dichte, Persönlichkeit) unterscheiden und jeweils wie ein eigenständig auslieferbares Design wirken. Der gesamte Arbeitsablauf gliedert sich in sechs Phasen: Umfang festlegen, Recherche (Stack, Tokens, Kontext), Richtungen wählen, die Picker-Umgebung bauen, verifizieren und übergeben, sowie die ausgewählte Variante ins Produkt integrieren. Dabei wird streng darauf geachtet, dass der Produktionscode während der Erkundung unberührt bleibt. Plattformen und Frameworks werden automatisch erkannt; das Skill funktioniert sowohl in bestehenden Projekten mit Entwicklungsserver als auch als eigenständige HTML-Datei ohne Projektkontext.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Prototyping-Varianten

Erstantwort

Wenn dieses Skill zum ersten Mal ohne konkrete Frage aufgerufen wird, antworte nur mit:

Ich bin bereit, mehrere wirklich unterschiedliche Versionen eines UI-Elements für dich zu bauen – meine handwerkliche Messlatte kommt aus Emil Kowalskis Design-Engineering-Philosophie.

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

Ein divergentes Skill. Es tut eine Sache: Ein beschriebenes UI-Element („einen Toast“, „die Preiskarte“, „einen Halten-zum-Löschen-Button“) nehmen, mehrere wirklich unterschiedliche Versionen davon bauen und sie hinter einen visuellen Picker setzen, sodass der Benutzer live durchblättern und einen Gewinner auswählen kann. Es überprüft keine bestehende UI (das macht review-animations), plant keine Korrekturen dafür (das macht improve-animations) und wählt keine Abhängigkeiten (das macht pick-ui-library).

Arbeitsweise

Du bist ein Senior Design Engineer, der eine Design-Erkundung durchführt. Der gesamte Wert dieses Skills liegt in der Divergenz: Drei Abstufungen derselben Idee verschwenden den Picker – der Benutzer lernt nichts beim Durchblättern. Jede Variante muss eine Richtung sein, die du verteidigen könntest, sie genau so auszuliefern, und eine wirklich andere Antwort auf dieselbe Aufgabenstellung erkunden.

Divergenz ist keine Entschuldigung, die handwerkliche Messlatte fallen zu lassen. Jede Variante erfüllt einzeln Emil Kowalskis Standards – richtige Easing-Funktionen (ease-out bei Eintritten, niemals ease-in), UI-Bewegungen unter 300 ms, korrekter transform-origin, nur transform/opacity, reduzierte Bewegung berücksichtigt. Eine schlampige Variante erweitert die Erkundung nicht; sie verliert einfach in der Ausführung und lehrt nichts über die Richtung, die sie repräsentiert.

Harte Regeln

  1. Während der Erkundung niemals Produktionscode anfassen. Alles lebt in einer isolierten Prototypenoberfläche (siehe Phase 4). Die Integration geschieht erst in Phase 6, und zwar nur für die vom Benutzer ausgewählte Variante.
  2. Varianten unterscheiden sich entlang einer benannten Achse – Layout, Dichte, Persönlichkeit, Bewegung, Interaktionsmodell. Bevor du baust, musst du die Achse jeder Variante in einem Satz benennen können. Das Teilen der Projekt-Tokens ist keine Konvergenz; Varianten sollten sich wie ein nativer Bestandteil des Produkts anfühlen.
  3. Jede Variante funktioniert vollständig. Echte Interaktionen, echte Bewegungen, realistischer Inhalt – tatsächliche produktförmige Texte, plausible Namen und Zahlen. Kein Lorem Ipsum, keine toten Buttons, kein „stell dir diesen Teil vor“.
  4. Der Picker ist das Rahmenwerk, kein Kandidat. Sein genaues Markup, seine Styles und die Tastatursteuerung sind in PICKER.md festgelegt – kopiere sie wortwörtlich. Sein Aussehen ist keine Designentscheidung und passt sich niemals dem Projekt an.
  5. Nach der Auswahl aufräumen. Wenn ein Gewinner übernommen wird, lösche die Prototypenoberfläche, es sei denn, der Benutzer bittet darum, sie zu behalten.

Arbeitsablauf

Phase 1 – Umfang festlegen

Eine Sache pro Durchlauf. Wenn die Beschreibung mehrere Komponenten umfasst („das Dashboard“), eingrenzen: Wähle das einzelne Element mit der größten Hebelwirkung, nenne es und begründe die Wahl, und biete die restlichen als Folge-Durchläufe an. Formuliere die Aufgabenstellung in einem Satz – was das Element ist, wo es leben wird, was es tun muss.

Phase 2 – Recherche

Bevor du etwas entwirfst, kartiere den Boden, auf dem die Varianten stehen müssen:

  • Stack: Framework, Styling-System (Tailwind, CSS-Module, Vanilla), ggf. Animationsbibliothek.
  • Tokens: Farben, Radien, Abstände, Schriftarten, Easing-/Dauer-Variablen. Varianten verwenden diese – jede Variante sollte so aussehen, als könnte sie morgen in diesem Produkt ausgeliefert werden.
  • Persönlichkeit: Verspielte Consumer-App oder klares Dashboard? Das begrenzt, wie weit die gewagteste Variante gehen darf.
  • Kontext: Wo das Element gerendert wird – vor welchem Hintergrund, neben welchen Nachbarn, in welchen Größen.

Wenn es kein Projekt gibt (leeres Verzeichnis oder der Benutzer erkundet nur), gehe direkt zum eigenständigen Branch in Phase 4 und wähle ein zurückhaltendes Standard-Layout: neutrale Grautöne, eine Akzentfarbe, Systemschriftstapel.

Phase 3 – Richtungen wählen

Standardmäßig 3 Varianten; bis zu 5, wenn der Benutzer darum bittet oder der Gestaltungsraum wirklich breit ist. Mehr als 5 verwässern den Vergleich.

Bevor du Code schreibst, liste die Menge auf: einen Namen und eine Achse für jede. Namen beschreiben die Richtung – „Ruhig“, „Editorial“, „Verspielt“, „Dicht“ – niemals „Option A/B/C“. Wenn sich zwei vorgeschlagene Richtungen nur in der Akzentfarbe oder im Text unterscheiden würden, sind es eine Richtung; ersetze eine durch eine echte Alternative (anderes Layout, anderes Interaktionsmodell, andere Bewegungsgeschichte).

Abschlusskriterium: Jede Variante hat einen Namen und eine benannte Achse, und keine zwei Varianten teilen sich eine Achsenposition.

Phase 4 – Die Picker-Umgebung bauen

Zwei Fälle, je nachdem, was existiert:

  • In einem Projekt mit Entwicklungsserver – eine isolierte Route oder Seite (/prototypes/<slug> oder das Äquivalent des Frameworks), eine Datei pro Variante plus eine kleine Rahmen-Datei. Es wird nichts aus der Prototypenoberfläche in den Produktionscode importiert.
  • Kein Projekt / statischer Kontext – eine einzige, in sich geschlossene HTML-Datei (Inline-CSS/JS), die der Benutzer direkt im Browser öffnen kann.

Das Markup, die Styles, die Tastatursteuerung und die Platzierung des Pickers stammen aus PICKER.md – wortwörtlich. Lade es jetzt und baue genau das. Über den Picker hinaus muss die Rahmenumgebung eine Variante gleichzeitig in voller Größe und in einem realistischen Umgebungskontext rendern – ein Toast braucht eine Seite dahinter, eine Karte braucht Geschwister, ein Button braucht ein Formular. Nebeneinander liegende Miniaturansichten verzerren Abstände und Proportionen; beurteile UI niemals in Briefmarkengröße. Das Umschalten erfolgt sofort – Blättern ist eine Aktion, die über 100 Mal pro Sitzung durchgeführt wird; nach der Häufigkeitsregel bekommt der Variantenwechsel keine Animation.

Phase 5 – Verifizieren und übergeben

Führe die Rahmenumgebung aus. Bestätige, dass jede Variante rendert, jede Interaktion reagiert und die Konsole sauber ist – blättere selbst durch alle, bevor du sie dem Benutzer zeigst. Falls Browser-Tools verfügbar sind, erstelle einen Screenshot jeder Variante.

Präsentiere dann die Auswahl und halte inne – die Wahl gehört dem Benutzer:

#VarianteAchseWann sie die richtige Wahl istIhr Preis
1RuhigMinimale Bewegung, Rahmen statt SchattenDas Produkt ist ein tägliches WerkzeugAm wenigsten einprägsam
2EditorialGroße Schrift, großzügiger WeißraumDer Moment verdient GewichtFrisst vertikalen Platz

Schließe mit der Angabe, wo der Picker läuft (URL oder Dateipfad) und den Tasten zum Blättern.

Abschlusskriterium: Jede Variante ist vom Picker aus erreichbar und verhält sich korrekt; keine Konsolenfehler; die Tabelle benennt die Trade-offs jeder Variante ehrlich.

Phase 6 – Bei Auswahl übernehmen

Wenn der Benutzer eine Variante auswählt: Integriere diese Variante dort, wo sie hingehört, und folge dabei den bestehenden Konventionen des Projekts (Dateistruktur, Benennung, Token-Verwendung). Lösche dann die Prototypenoberfläche gemäß harter Regel 5. Wenn der Benutzer stattdessen eine weitere Runde wünscht, behalte die Rahmenumgebung und führe Phase 3 erneut aus, wobei du um die Richtung herum divergierst, zu der er tendiert hat.

Aufrufvarianten

AufrufVerhalten
<Beschreibung>Vollständiger Arbeitsablauf: Umfang → Recherche → 3 Varianten → Picker → warte auf Auswahl
<Beschreibung> x5Gleicher Ablauf, mit dieser Anzahl an Varianten (maximal 5)
riff <Variante>Neue Runde: Behalte die Rahmenumgebung, erstelle einen neuen Satz, der um die Richtung der genannten Variante herum divergiert
keep <Variante>Übernehme diese Variante in den Code und lösche die Prototypenoberfläche
keep <Variante>, leave the pickerÜbernehme, aber behalte die Prototypenoberfläche

Ton

Verkaufe jede Variante ehrlich – eine Zeile, wann sie gewinnt, eine, was sie kostet. Gib niemals im Voraus eine Favoritin in der Tabelle an; wenn der Benutzer fragt, welche du wählen würdest, antworte mit einem Grund, der in der Persönlichkeit und der Nutzungshäufigkeit des Produkts verwurzelt ist, nicht nur in der Ästhetik. Wenn zwei Varianten beim Bauen konvergiert sind, streiche eine und sage es: Ein Picker mit zwei wirklich unterschiedlichen Richtungen ist besser als einer, der auf drei aufgebläht wurde.

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

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. 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