ask-emil

Pregunta qué skill o flujo se adapta a tu situación. Un enrutador para las skills de este repositorio.

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

Más skills de emilkowalski

animate
emilkowalski
Crea una animación desde cero, tomando las decisiones en el orden que determina si se siente correcta: si debería animarse, con qué propósito, qué herramienta, qué propiedades, qué curva y duración, cómo interrumpe, cómo sale. Escribe la implementación. Úsalo cuando se te pida animar algo, añadir movimiento, hacer que un componente se sienta vivo o construir una transición. Para criticar movimiento existente usa review-animations; para auditar un código completo usa improve-animations.
animate-expo
emilkowalski
Crea animaciones en React Native y Expo, tomando las decisiones en el orden que determina si se sienten bien: si debe animarse, en qué hilo se ejecuta, qué propiedades, si usar spring o timing, cómo se transfiere el control del gesto y cómo se degrada. Escribe la implementación con Reanimated, Gesture Handler, Expo Router y expo-haptics. Úsalo al animar cualquier elemento en una app de Expo, añadir gestos, hojas, transiciones de pantalla, respuesta al pulsar o háptica, o corregir animaciones entrecortadas en el dispositivo. Para...
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
Glosario de búsqueda inversa que convierte una descripción vaga de una animación web o efecto de movimiento en su término exacto ("la cosa que rebota cuando se abre un popover" → Pop in; "el desplazamiento elástico de iOS" → Rubber-banding). Se usa cuando el usuario pregunta "¿cómo se llama cuando…", o describe un efecto de movimiento sin saber su nombre y quiere la palabra correcta para indicársela a una IA o diseñador. Sirve para nombrar un efecto, no para diseñarlo o construirlo.
researchdesigncreative
apple-design
emilkowalski
El enfoque de Apple para el diseño de interfaces y el movimiento físico y fluido, traducido para la web. Úsalo al construir o revisar interfaces basadas en gestos, animaciones con resorte, interacciones de arrastre/deslizamiento/hoja, momentum y transiciones interrumpibles, materiales translúcidos y profundidad, tipografía (tamaño óptico, tracking, interlineado), movimiento reducido, o los fundamentos de diseño (retroalimentación, consistencia espacial, moderación) detrás de las interfaces al estilo Apple.
ask-sonner
emilkowalski
Guía de Sonner, la librería de toasts de React — instala y configura el Toaster, elige la llamada toast() correcta, toasts de promesa y de carga, actualizar, descartar y persistir toasts, estilos, temas e iconos, posicionamiento y múltiples toasters. Úsalo al trabajar con Sonner o al solucionar problemas — toasts que no aparecen, aparecen dos veces, pierden sus estilos, ignoran las clases de Tailwind, quedan detrás de un modal o no siguen el modo oscuro.
break-ui
emilkowalski
Intenta romper una pieza de la interfaz de usuario proporcionándole datos en el peor de los casos: nombres largos, correos electrónicos sin puntos de corte, nombres de una sola letra, campos faltantes, cantidades enormes, cero elementos, etiquetas largas, texto no latino, emojis y números extremos. Luego, muéstrala detrás de un interruptor «Datos de demostración / Peor caso» e informa de todo lo que se rompió, junto con la solución para cada problema. Úsalo cuando el usuario pida someter a pruebas de estrés, romper o encontrar casos límite en un componente o una pantalla, o «probar el peor caso». Para críticas de diseño visual, usa emil-design-eng; para movimiento...
testingdesigndevelopment
choreograph
emilkowalski
Coordina varios elementos que se animan juntos: decide qué se mueve, en qué orden, cuánto se superponen y qué permanece quieto, para que el grupo se perciba como un único movimiento intencional en lugar de un conjunto de animaciones separadas. Úsalo al crear o corregir una lista escalonada, la entrada de una sección principal, un cambio de vista dentro de un contenedor, un flujo de varios pasos, un elemento que sale mientras sus elementos hermanos cierran el espacio, una transformación entre estados complejos o cualquier interacción con varias partes móviles (icono + fondo + líneas, panel +...
designdevelopment