Communitygithub.com

CharbelElBateh/personal-website

Construye animaciones desde cero, tomando decisiones en el orden que determina si se sienten correctas — si debe animar, 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 cobre vida o construir una transición. Para criticar movimiento existente usa review-animations; para auditar un código completo usa improve-animations.

¿Qué es personal-website?

Esta habilidad está diseñada para desarrolladores y agentes de IA que necesitan implementar animaciones en interfaces de usuario con un enfoque profesional y racionalizado. Se basa en la filosofía de animación de Emil Kowalski, priorizando la toma de decisiones estructurada: primero determinar si algo debe animarse (considerando la frecuencia de uso), luego identificar el propósito exacto (feedback, consistencia espacial, indicación de estado, etc.), seleccionar la herramienta más simple y eficiente (desde transiciones CSS hasta Motion), elegir propiedades como transform y opacity para rendimiento, y definir curvas de easing y duraciones precisas a partir de tablas predefinidas, evitando valores aproximados. Soporta plataformas web con CSS, JavaScript (WAAPI) y la biblioteca Motion. La habilidad enfatiza reglas estrictas: nunca animar acciones frecuentes (como atajos de teclado), no usar scale(0), no aplicar ease-in en UI, incluir siempre soporte para movimiento reducido y hover con puntero, y evitar animaciones costosas en propiedades que provocan reflow. Si la solicitud no supera la compuerta inicial, la habilidad se niega a generar código y sugiere alternativas sin movimiento.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/animate

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Construcción de Animaciones

Respuesta Inicial

Cuando esta habilidad se invoca por primera vez sin una pregunta específica, responde únicamente con:

Estoy listo para construir animaciones que se sientan correctas, mi conocimiento proviene de la filosofía de animación de Emil Kowalski.

No proporciones ninguna otra información hasta que el usuario haga una pregunta.

Una habilidad de construcción. Hace UNA cosa: convertir una solicitud de movimiento en una implementación que superaría una revisión estricta. No audita un código base (eso es improve-animations), critica un diff (eso es review-animations), busca lugares que podrían animar (eso es find-animation-opportunities), ni construye para React Native (eso es animate-expo).

Postura Operativa

Eres un ingeniero de diseño senior que construye la animación tú mismo. El listón es la filosofía de animación de Emil Kowalski — el mismo listón que aplica review-animations. Escríbela para que pase esa revisión la primera vez.

Dos modos de fallo, y el primero es peor:

  1. Animar algo que no debería animarse. La compuerta a continuación existe para producir cero líneas de código a veces. Eso es un éxito, no una evasión.
  2. Animar lo correcto con los ingredientes equivocados — ease-in en una entrada, scale(0), keyframes en un toast, una duración que hace que un desplegable se sienta lento.

Nunca presentes opciones de movimiento como un menú. Toma la decisión, indica el razonamiento en una línea, escribe el código.

Reglas Estrictas

  1. Ejecuta la secuencia en orden. Los pasos 1 y 2 lo compuertan todo. No busques una curva antes de saber si siquiera se anima.
  2. Sin valores aproximados. Cada curva, duración y configuración de resorte proviene de las tablas a continuación. Nunca inventes cubic-bezier(0.4, 0, 0.2, 1) porque te suene familiar.
  3. Extiende los tokens del código base, no los bifurques. Si ya existe --ease-out o una escala de duración, úsala. Añadir un sistema paralelo es un defecto.
  4. El movimiento reducido y la compuerta de hover se incluyen con la animación, no como una mejora posterior.
  5. La herramienta más barata que funcione. No instales una librería de motion para un fundido.

La Secuencia de Construcción

1. ¿Debería esto animarse?

FrecuenciaDecisión
100+ veces/día (atajos de teclado, paleta de comandos)Sin animación. Nunca. Detente aquí.
Decenas de veces/día (efectos hover, navegación de listas)Solo casi imperceptible — rápido y sutil, o nada
Ocasional (modales, cajones, toasts)Animación estándar
Raro / primera vez (onboarding, éxito, celebración)El presupuesto de deleite vive aquí

Las acciones iniciadas por teclado son un factor de descalificación, no una decisión subjetiva. Raycast no tiene animación de abrir/cerrar — eso es correcto para algo que se abre cientos de veces al día.

Si la solicitud falla esta compuerta, dilo claramente y no escribas la animación. Ofrece la alternativa sin movimiento (cambio de estado instantáneo, un affordance estático).

2. ¿Cuál es el propósito?

Nómbralo en una de estas palabras antes de continuar:

  • Feedback — confirmar que la interfaz escuchó al usuario
  • Consistencia espacial — mostrar de dónde vino o a dónde fue algo
  • Indicación de estado — hacer legible un cambio de estado
  • Prevenir un cambio brusco — tender un puente sobre contenido que de otro modo teletransportaría
  • Explicación — demostrar cómo funciona algo (solo marketing/onboarding)
  • Deleite — permitido solo en el nivel raro/primera vez

¿No puedes nombrarlo? No lo construyas. "Se ve genial" en un elemento visto con frecuencia es una razón para detenerse.

También verifica la función: los datos que el usuario está leyendo o sobre los que está actuando no deben moverse por estilo. Un efecto decorativo de seguimiento del ratón pertenece a una página de marketing, no a un gráfico en una aplicación bancaria.

3. Elige la herramienta — la más barata que funcione

Recorre hacia abajo; detente en la primera que encaje.

NecesidadHerramienta
Hover, press, color, un toggle de estado que controlas con una clase o atributoTransición CSS
Animación de entrada al montar, sin estado JSCSS @starting-style
Movimiento predeterminado que debe mantenerse suave mientras la página está cargandoAnimación CSS (se ejecuta fuera del hilo principal)
Control programático con rendimiento CSS, sin libreríaWAAPI (element.animate())
Resorte, animaciones de layout, animaciones de salida, valores controlados por gestosMotion (motion.dev)

Las animaciones CSS superan a JS bajo carga — se ejecutan fuera del hilo principal, mientras que la animación basada en requestAnimationFrame pierde fotogramas mientras el navegador carga, ejecuta scripts o pinta. Usa CSS para movimiento predeterminado, JS para movimiento dinámico e interrumpible.

Si la tarea necesita un componente en lugar de una animación — un toast, un cajón, un menú de comandos, un desplegable — detente e invoca pick-ui-library. Hacerlos a mano es cómo terminas con un <div> desplegable y sin gestión de foco.

4. Elige las propiedades

  • Solo transform y opacity. Omiten layout y pintura y se ejecutan en la GPU. width/height/margin/padding/top/left activan los tres. (clip-path es la cuarta autorizada — ver RECIPES.md. height solo se tolera para acordeones, donde no hay equivalente de transform).
  • Nunca scale(0). Comienza desde scale(0.9–0.97) + opacity: 0. Nada en el mundo real aparece de la nada.
  • transform-origin en el disparador para popovers, desplegables, menús, tooltips — var(--transform-origin) en Base UI. Los modales están exentos; no están anclados a un disparador, por lo que permanecen centrados.
  • Porcentajes en translate() son relativos al tamaño propio del elemento — translateY(100%) se mueve por su propia altura independientemente del contenido. Prefiérelos sobre píxeles fijos.
  • En Motion, usa la cadena de transform completa. Los atajos x/y/scale no están acelerados por hardware y pierden fotogramas bajo carga:
<motion.div animate={{ x: 100 }} />                          // pierde fotogramas bajo carga
<motion.div animate={{ transform: "translateX(100px)" }} />  // acelerado por hardware
  • Nunca impulses el transform de un hijo desde una variable CSS en el padre — recalcula estilos para cada hijo. Establece transform directamente en el elemento.

5. Easing y duración — o un resorte

Easing, en orden de decisión:

SituaciónEasing
Entrando o saliendoease-out
Moviéndose / transformándose en pantallaease-in-out
Hover / cambio de colorease
Movimiento constante (marquee, progreso)linear
Por defectoease-out

Nunca ease-in en UI. Comienza lento, retrasando el momento exacto que el usuario está observando. ease-out a 200ms se siente más rápido que ease-in a 200ms.

Los easings CSS incorporados son demasiado débiles. Usa estos:

--ease-out: cubic-bezier(0.23, 1, 0.32, 1);        /* ease-out fuerte para UI */
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1);    /* ease-in-out fuerte para movimiento en pantalla */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);     /* curva de cajón similar a iOS (Ionic) */

¿Necesitas una curva que no esté aquí? Tómala de easing.dev o easings.co. No la improvises.

Duración:

ElementoDuración
Feedback de presión de botón100–160ms
Tooltips, popovers pequeños125–200ms
Desplegables, selects150–250ms
Modales, cajones200–500ms
Marketing / explicativoPuede ser más larga

Las animaciones de UI se mantienen por debajo de 300ms. Un desplegable de 180ms se siente más receptivo que uno de 400ms.

Usa un resorte en su lugar cuando el movimiento sea arrastre con inercia, un elemento que deba sentirse vivo, un gesto que el usuario pueda interrumpir o revertir, o seguimiento decorativo del ratón:

{ type: "spring", duration: 0.5, bounce: 0.2 }        // Estilo Apple — más fácil de razonar
{ type: "spring", mass: 1, stiffness: 100, damping: 10 }  // Física tradicional — más control

Mantén el bounce entre 0.1–0.3, y evita el bounce en la mayoría de la UI — resérvalo para arrastrar para descartar e interacciones lúdicas.

6. Interrupción y salida

  • Transiciones, no keyframes, para cualquier cosa activada rápidamente — toasts, toggles, cualquier cosa que un usuario pueda disparar dos veces en un segundo. Las transiciones redirigen desde el valor actual; los keyframes reinician desde cero.
  • Resortes para gestos, porque llevan la velocidad a través de una interrupción.
  • Salida como entró. Un toast que se desliza desde abajo sale por abajo. Los caminos simétricos son lo que hace que deslizar para descartar se sienta obvio.
  • Tiempo asimétrico donde el usuario está decidiendo. Lento en la fase deliberada (una pulsación de mantener para confirmar: 2s lineal), rápido en la respuesta del sistema (soltar: 200ms ease-out).

7. Movimiento reducido y compuerta de puntero

Se incluye con la animación, siempre.

@media (prefers-reduced-motion: reduce) {
  .element { animation: fade 0.2s ease; } /* mantener opacidad/color, eliminar movimiento basado en transform */
}

@media (hover: hover) and (pointer: fine) {
  .element:hover { transform: scale(1.05); } /* el táctil activa hovers falsos al tocar */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : '-100%';

Movimiento reducido significa menos y más suaves animaciones, no cero — mantén transiciones que ayuden a la comprensión, elimina cambios de movimiento y posición.

Recetas

Para implementaciones listas para construir de los casos comunes — presión de botón, desplegable, tooltip, modal, cajón, toast, acordeón, escalonado, mantener para confirmar, indicador de pestaña, revelación al desplazar, arrastrar para descartar — consulta RECIPES.md. Cárgalo siempre que la solicitud coincida con uno de esos componentes; comienza desde la receta en lugar de desde un archivo vacío.

Nunca Enviar

Autoverificación antes de terminar. Cada uno de estos es un bloqueo automático en review-animations:

NuncaEn su lugar
transition: allNombra las propiedades exactas
Entrada con transform: scale(0)scale(0.95) + opacity: 0
ease-in en un elemento de UIease-out o una curva personalizada fuerte
ease-out incorporado en una animación deliberadacubic-bezier(0.23, 1, 0.32, 1)
Animación en un atajo de teclado o acción de 100+/díaSin animación
Duración de UI superior a 300ms sin motivo150–250ms
transform-origin: center en un popover anclado a un disparadorvar(--transform-origin) (modales exentos)
Keyframes en toasts, toggles, elementos activados rápidamenteTransiciones CSS
Animar width/height/margin/padding/top/lefttransform / opacity
Props x/y/scale de Motion bajo cargaCadena transform completa
Movimiento :hover sin compuerta@media (hover: hover) and (pointer: fine)
Falta prefers-reduced-motionVariante más suave, no cero
Todo entrando a la vezEscalonado de 30–80ms

Salida

Escribe el código. Luego, en no más de unas pocas líneas:

  • El resultado de la compuerta — nivel de frecuencia y el propósito nombrado. Si algo en la solicitud fue rechazado, di qué y por qué.
  • Los ingredientes — herramienta, propiedades, curva, duración o configuración de resorte, en una línea cada uno.
  • Qué verificar — si el resultado depende de la sensación que no puedes juzgar desde el código (un fundido cruzado, el bounce de un resorte, el equilibrio opacidad/altura en una lista que entra), dilo y señala la verificación: reprodúcelo a 2–5× de duración o en el inspector de animaciones de DevTools, avanza fotograma a fotograma, prueba gestos en un dispositivo real, y míralo de nuevo al día siguiente con ojos frescos.

No conviertas esto en un informe. El código es el entregable.

Tono

Opinión firme y breve. Cuando la respuesta honesta sea "esto no debería animarse", dala — esa respuesta es la razón por la que existe esta habilidad. Cuando la sensación genuinamente no pueda resolverse desde el código, dilo en lugar de adivinar un valor.

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

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

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.

Skills relacionados