ask-emil

Frage, welcher Skill oder Flow zu deiner Situation passt. Ein Router für die Skills in diesem Repo.

npx skills add https://github.com/emilkowalski/skills --skill ask-emil

Ask Emil

Before stating what a skill does or recommending one, read that skill's SKILL.md: the summaries here are for orientation only. Then recommend one skill (or one short sequence) for the user's situation, say why in a sentence, and name the skill they'd reach for next. Don't list the whole map back at them.

A flow is a path through the skills. Most UI work travels one main flow, from idea to shipped. Some skills are upkeep you run on a codebase that already exists, some are references that sit underneath everything, and a few stand alone.

The main flow: idea → ship

  1. Not sure what it should look or feel like? Detour through /prototype. It builds several genuinely different versions behind a live picker, then promotes the one you pick into the real code. Reach for it whenever a design question is hard to settle in words.

  2. Build it. Pick the builder by what's moving:

    • /pick-ui-library first if the task needs a dependency (dropdown, dialog, toast, drawer, command menu, drag and drop, charts). Don't let the agent hand-roll a toast.
    • /animate for one animation on the web: whether to animate at all, then tool, properties, curve, duration, interruption, exit.
    • /choreograph when several elements move together: staggers, hero entrances, view swaps, an item leaving while siblings close the gap.
    • /gestures when the user's finger drives it: drag, swipe, sheets, snap points, swipe-to-dismiss.
    • /animate-expo for any of the above in React Native or Expo.
    • /ask-sonner when the work is toasts with Sonner.
  3. Try to break it. Before calling it done:

    • /break-ui feeds it worst-case data (long names, empty lists, huge counts, emoji, non-Latin text) behind a toggle and reports what broke.
    • /review-animations reviews the motion in the diff against a strict bar. Default to flagging; approval is earned.
    • /mobile-native if it runs on a phone as a web app: sticky hover, the 100vh bug, inputs that zoom, safe areas.
    • /animation-performance if anything drops frames.
  4. Learn from the session. /learn-taste closes the loop. Run it at the end, in the same session, before you clear: it collects every design correction you made (including edits you made yourself) and turns each into a rule with its why, so the next agent doesn't repeat the mistake.

Upkeep: a codebase that already exists

Not feature work. Run these when you have a spare moment, or when the app "feels off".

  • The motion needs work across the app → /improve-animations. Read-only: it audits every animation and writes prioritized, self-contained plans another agent (or a cheaper model) can execute.
  • It feels static → /find-animation-opportunities. Read-only: it proposes motion with exact values, and rejects everything that shouldn't move. Build the ones you accept with /animate.
  • It feels slow or over-animated → /remove-animations. Edits code, but only to subtract: motion on keyboard actions, high-frequency surfaces, decoration with no purpose.

These three cover different questions. If the user isn't sure which, ask whether the problem is bad motion, missing motion, or too much motion.

References underneath

Model-invoked skills the others lean on. Reach for them directly when the knowledge, not a process, is what's missing.

  • /emil-design-eng: the core philosophy for UI polish, component interactions, and the invisible details. The fallback when no narrower skill fits.
  • /apple-design: Apple's principles for interface design and fluid, physical motion, translated for the web.
  • /animation-vocabulary: when the problem is the word. "What's it called when…" turns a vague description into the exact term to prompt with.

Standalone

  • /write-swift: modern Swift, Swift 6 concurrency, and native iOS code. Off the web flow entirely.

Common situations

You sayReach for
"Animate this"/animate
"These should come in one after another"/choreograph
"It doesn't follow my finger"/gestures
"It stutters" / "it's janky"/animation-performance
"Does this animation feel right?"/review-animations
"Make the app feel better"/improve-animations
"What could animate here?"/find-animation-opportunities
"Too much is moving"/remove-animations
"Give me a few options"/prototype
"Which library should I use?"/pick-ui-library
"Works in Chrome, feels wrong on my phone"/mobile-native
"Try the worst case"/break-ui
"What's that bouncy thing called?"/animation-vocabulary
"Stop making that mistake"/learn-taste

Mehr Skills von emilkowalski

animate
emilkowalski
Erstelle eine Animation von Grund auf und triff die Entscheidungen in der Reihenfolge, die bestimmt, ob sie sich richtig anfühlt – soll sie überhaupt animieren, welcher Zweck, welches Werkzeug, welche Eigenschaften, welche Kurve und Dauer, wie sie unterbricht, wie sie endet. Schreibt die Implementierung. Verwenden, wenn darum gebeten wird, etwas zu animieren, Bewegung hinzuzufügen, eine Komponente lebendig wirken zu lassen oder einen Übergang zu bauen. Für Kritik an bestehender Bewegung review-animations verwenden; für die Prüfung einer gesamten Codebasis improve-animations verwenden.
animate-expo
emilkowalski
Erstellt Animationen in React Native und Expo und trifft die Entscheidungen in der Reihenfolge, die darüber bestimmt, ob sie sich richtig anfühlen: Soll etwas animiert werden, auf welchem Thread läuft die Animation, welche Eigenschaften werden animiert, Spring oder Timing, wie wird die Geste übergeben und wie verhält sich die Animation bei eingeschränkten Bedingungen? Schreibt die Implementierung mit Reanimated, Gesture Handler, Expo Router und expo-haptics. Verwenden, wenn in einer Expo-App etwas animiert, Gesten hinzugefügt, Sheets, Bildschirmübergänge, Feedback beim Drücken oder haptisches Feedback umgesetzt oder ruckelnde Animationen auf dem Gerät behoben werden sollen. Für...
developmentdesign
animation-performance
emilkowalski
Keep web animations inside the frame budget — animate composite-only properties, keep motion off the main thread when the page is busy, and find the cause when an animation drops frames. Use when an animation is janky, choppy, stutters, or drops frames; when choosing which property to animate; when deciding between CSS and JS animation on performance grounds; or when reaching for `will-change` or GPU layers. For choosing easing, duration, or whether to animate at all use animate; for...
developmentdesign
animation-vocabulary
emilkowalski
Umgekehrtes Nachschlageglossar, das eine vage Beschreibung einer Web-Animation oder Bewegungswirkung in den genauen Begriff umwandelt („das Hüpfende, wenn ein Popover aufgeht“ → Pop in; „das iOS-Gummiband-Scrollen“ → Rubber-banding). Verwenden, wenn der Benutzer fragt: „Wie heißt das, wenn…“ oder eine Bewegungswirkung beschreibt, ohne deren Namen zu kennen, und das richtige Wort für eine KI oder einen Designer benötigt. Zum Benennen einer Wirkung, nicht zum Entwerfen oder Erstellen.
researchdesigncreative
apple-design
emilkowalski
Apples Ansatz für Interface-Design und flüssige, physikalische Bewegung, für das Web übersetzt. Verwenden beim Erstellen oder Überprüfen von gestengesteuerten Benutzeroberflächen, Federanimationen, Drag-/Swipe-/Sheet-Interaktionen, Momentum und unterbrechbaren Übergängen, transluzenten Materialien und Tiefe, Typografie (optische Größenanpassung, Laufweite, Zeilenabstand), reduzierter Bewegung oder den Design-Grundlagen (Feedback, räumliche Konsistenz, Zurückhaltung) hinter Apple-ähnlichen Oberflächen.
ask-sonner
emilkowalski
Leitfaden für Sonner, die React-Toast-Bibliothek — Installation und Einrichtung des Toasters, Auswahl des richtigen toast()-Aufrufs, Promise- und Lade-Toasts, Aktualisieren, Schließen und Beibehalten von Toasts, Styling, Theming und Icons, Positionierung und mehrere Toaster. Verwenden Sie dies, wenn Sie mit Sonner arbeiten oder Probleme beheben — Toasts, die nicht erscheinen, doppelt erscheinen, ihre Stile verlieren, Tailwind-Klassen ignorieren, hinter einem Modal liegen oder den Dunkelmodus nicht befolgen.
break-ui
emilkowalski
Versuche, ein UI-Element mit Worst-Case-Daten zu überfordern – langen Namen, nicht umbrechbaren E-Mail-Adressen, einbuchstabigen Namen, fehlenden Feldern, riesigen Zahlen, null Elementen, langen Beschriftungen, nichtlateinischem Text, Emojis und extremen Zahlen. Zeige es anschließend hinter einem Schalter „Demodaten / Worst Case“ an und melde alles, was kaputtgegangen ist, samt jeweiliger Lösung. Verwende dies, wenn der Nutzer einen Stresstest durchführen, eine Komponente oder einen Bildschirm kaputtmachen oder Grenzfälle finden lassen möchte oder darum bittet, „den Worst Case auszuprobieren“. Für Kritik am visuellen Design verwende emil-design-eng; für Animationen …
testingdesigndevelopment
choreograph
emilkowalski
Mehrere Elemente koordinieren, die sich gemeinsam bewegen: festlegen, was sich bewegt, in welcher Reihenfolge, wie stark sich die Bewegungen überlappen und was stillsteht – damit eine Gruppe wie eine einzige, bewusst gestaltete Bewegung wirkt und nicht wie eine Ansammlung einzelner Animationen. Verwenden, wenn eine gestaffelte Liste, ein Hero-Einstieg, ein Ansichtswechsel innerhalb eines Containers, ein mehrstufiger Ablauf, ein Element, das verschwindet, während seine Geschwister die Lücke schließen, eine Verwandlung zwischen komplexen Zuständen oder eine Interaktion mit mehreren beweglichen Teilen (Symbol + Hintergrund + Linien, Panel + …) erstellt oder repariert wird.
designdevelopment