ask-emil

tarafından emilkowalski

Ask which skill or flow fits your situation. A router over the skills in this 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

emilkowalski tarafından daha fazla skill

animate
emilkowalski
Sıfırdan bir animasyon oluştur, kararları doğru hissettirip hissettirmediğini belirleyen sırayla ver — hiç animasyon yapılmalı mı, hangi amaçla, hangi araçla, hangi özelliklerle, hangi eğri ve süreyle, nasıl kesintiye uğrar, nasıl çıkar. Uygulamayı yazar. Bir şeyi animasyonlandırması istendiğinde, hareket eklemesi, bir bileşeni canlı hissettirmesi veya bir geçiş oluşturması istendiğinde kullan. Mevcut hareketi eleştirmek için review-animations kullan; tüm bir kod tabanını denetlemek için improve-animations kullan.
animate-expo
emilkowalski
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...
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
Bir web animasyonu veya hareket efektinin belirsiz bir tanımını tam terimine dönüştüren tersine sözlük ("bir popover açılırkenki zıplama efekti" → Pop in; "iOS lastik bant kaydırma" → Rubber-banding). Kullanıcı "şunun adı neydi…" diye sorduğunda veya bir hareket efektini adını bilmeden tanımlayıp bir yapay zekaya veya tasarımcıya sormak için doğru kelimeyi istediğinde kullanılır. Bir efekti adlandırmak içindir, tasarlamak veya oluşturmak için değil.
researchdesigncreative
apple-design
emilkowalski
Apple'ın arayüz tasarımına yaklaşımı ve akıcı, fiziksel hareketi web için çevrilmiştir. Jest tabanlı kullanıcı arayüzü, yaylı animasyonlar, sürükle/kaydır/sayfa etkileşimleri, momentum ve kesintisiz geçişler, yarı saydam malzemeler ve derinlik, tipografi (optik boyutlandırma, karakter aralığı, satır aralığı), azaltılmış hareket veya Apple tarzı arayüzlerin arkasındaki tasarım temelleri (geri bildirim, mekansal tutarlılık, ölçülülük) oluşturulurken veya incelenirken kullanın.
ask-sonner
emilkowalski
Sonner, React toast kütüphanesi rehberi — Toaster'ı kurun ve bağlayın, doğru toast() çağrısını seçin, promise ve yükleme toast'ları, toast'ları güncelleme, kapatma ve kalıcı hale getirme, stillendirme, temalama ve simgeler, konumlandırma ve birden fazla toaster. Sonner ile çalışırken veya sorun giderirken kullanın — görünmeyen, iki kez görünen, stillerini kaybeden, Tailwind sınıflarını yok sayan, bir modalın arkasında kalan veya karanlık modu takip etmeyen toast'lar.
break-ui
emilkowalski
Uzun adlar, bölünemeyen e-posta adresleri, tek harfli adlar, eksik alanlar, çok büyük sayılar, sıfır öğe, uzun etiketler, Latin alfabesi dışındaki metinler, emoji ve uç değerler gibi en kötü durum verileriyle bir UI parçasını bozmaya çalışın; ardından bunu "Demo data / Worst case" anahtarının arkasında görüntüleyin ve bozulan her şeyi, her biri için çözümüyle birlikte raporlayın. Kullanıcı bir bileşeni veya ekranı stres testine tabi tutmanızı, bozmanızı ya da uç durumları bulmanızı veya "en kötü durumu denemenizi" istediğinde kullanın. Görsel tasarım eleştirisi için emil-design-eng kullanın; hareket için...
testingdesigndevelopment
choreograph
emilkowalski
Coordinate several elements that animate together — decide what moves, in what order, how much they overlap, and what stays still — so a group reads as one intentional motion instead of a pile of separate animations. Use when building or fixing a staggered list, a hero entrance, a view swap inside a container, a multi-step flow, an element leaving while its siblings close the gap, a morph between rich states, or any interaction with several moving parts (icon + background + lines, panel +...
designdevelopment