Communitygithub.com

Asymmetric-al/core

Construye una animación desde cero, tomando las decisiones en el orden que determina si se siente correcta: si debe animarse, con qué propósito, qué herramienta, qué propiedades, qué curva y duración, cómo interrumpe y cómo sale. Escribe la implementación. Úsalo cuando te pidan animar algo, añadir movimiento, hacer que un componente cobre vida o construir una transición.

¿Qué es core?

Asymmetric-al/core es una habilidad de IA para construir implementaciones de animaciones web que superarían una revisión estricta. Está diseñado para desarrolladores e ingenieros de diseño senior que trabajan con motion en la web, siguiendo la filosofía de animación de Emil Kowalski. La habilidad impone un flujo de trabajo secuencial de siete pasos: primero evalúa si una animación debería existir según la frecuencia de la interacción, luego nombra explícitamente su propósito, elige la herramienta más económica (CSS transitions, WAAPI, o Motion), selecciona propiedades como solo transform y opacity, define curvas y duraciones a partir de tokens predefinidos, maneja interrupción y salida, y finalmente añade soporte para movimiento reducido y hover con puntero fino. Se ejecuta solo cuando se invoca explícitamente y no reacciona por sí solo. La habilidad es parte del repositorio Asymmetric-al/core y debe reconciliarse tras actualizaciones de los contratos de diseño-ingeniería y motion operativo.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/animate

Preguntar en tu IA favorita

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

Documentación

Construcción de Animaciones

Este repositorio (Asymmetric-al/core)

Usa esta habilidad para implementar motion web después de los contratos de diseño-ingeniería y motion operativo de Core. Reconoce esta superposición después de las actualizaciones ascendentes antes de ejecutar bun run skills:sync.

Desencadenantes

  • Construir o reescribir una animación web, transición o micro-interacción.
  • No la uses para Expo/React Native (animate-expo), una auditoría de código base (improve-animations), o una revisión estricta solo de motion (review-animations).

Flujo de trabajo

  1. Carga docs/ai/skills/emil-design-engineering/SKILL.md y docs/ai/skills/anim/SKILL.md primero.
  2. Reutiliza los tokens de motion existentes de Core y los primitivos de Base UI. No bifurques duraciones, easing, ni introduzcas APIs de Radix.
  3. Mantén el motion reducido en la línea base global en packages/ui/styles/globals.css.
  4. Si la tarea necesita un toast, drawer, menú o dropdown, reutiliza @asym/ui / Base UI. No invoques pick-ui-library a menos que el usuario haya preguntado explícitamente qué biblioteca usar.

Lista de verificación

  • La animación tiene un propósito y se mantiene en transform/opacity donde sea posible.
  • Los tokens de Core, Base UI y anim prevalecen sobre los valores ilustrativos ascendentes.
  • Las utilidades compartidas y @asym/lib/motion-presets son preferidas sobre nuevos literales de temporización.

Una habilidad de construcción. Hace UNA cosa: convertir una solicitud de motion 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 animarse (eso es find-animation-opportunities), ni construye para React Native (eso es animate-expo).

Postura Operativa

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

Dos modos de fallo, y el primero es peor:

  1. Animar algo que no debería animarse. La compuerta de abajo 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 dropdown se sienta lento.

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

Reglas Estrictas

  1. Ejecuta la secuencia en orden. Los pasos 1 y 2 lo gobiernan todo. No busques una curva antes de saber si se anima en absoluto.
  2. Sin valores aproximados. Cada curva, duración y configuración de spring proviene de las tablas de abajo. Nunca inventes cubic-bezier(0.4, 0, 0.2, 1) porque te parezca familiar.
  3. Amplía los tokens del código base, no los bifurques. Si --ease-out-soft o un token de duración ya existe en packages/ui/styles/globals.css, úsalo. Añadir un sistema paralelo es un defecto.
  4. El motion reducido y el gating por hover se incluyen con la animación, no como un seguimiento.
  5. La herramienta más barata que funcione. No instales una biblioteca de motion para un simple fundido.

La Secuencia de Construcción

1. ¿Debería animarse esto?

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

Las acciones iniciadas por teclado son un inhabilitante, no una decisión negociable. Raycast no tiene animación de apertura/cierre — 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 motion (cambio de estado instantáneo, una indicación estática) en su lugar.

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

Nómbralo con 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 — puentear contenido que de otro modo teletransportaría
  • Explicación — demostrar cómo funciona algo (solo marketing/onboarding)
  • Alegría — permitido solo en el nivel raro/primera vez

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

También verifica la función: los datos que el usuario está leyendo o en los que actúa 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, presionar, 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 cargaAnimación CSS (se ejecuta fuera del hilo principal)
Control programático con rendimiento CSS, sin bibliotecaWAAPI (element.animate())
Springs, animaciones de layout, animaciones de salida, valores guiados 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, scriptea 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 drawer, un menú de comandos, un dropdown — reutiliza @asym/ui y Base UI. No invoques pick-ui-library a menos que el usuario haya preguntado explícitamente qué biblioteca usar. Hacerlos a mano es cómo terminas con un dropdown de <div> y sin gestión de foco.

4. Elige las propiedades

  • Solo transform y opacity. Saltan layout y pintado y se ejecutan en la GPU. width/height/margin/padding/top/left activan los tres. (clip-path es la cuarta sancionada — ver RECIPES.md. height se tolera solo 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 desencadenante para popovers, dropdowns, menús, tooltips — var(--transform-origin) en Base UI. Los modales están exentos; no están anclados a un desencadenante, así que permanecen centrados.
  • Los 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 codificados.
  • En Motion, x, y y scale son transformaciones independientes compatibles. Son eficientes. Usa una cadena transform completa solo cuando la animación deba permanecer en el compositor mientras el hilo principal está ocupado:
<motion.div animate={{ x: 100 }} />
<motion.div animate={{ transform: "translateX(100px)" }} />
  • Nunca impulses la transformación 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 spring

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. Empieza lento, retrasando el momento exacto que el usuario está observando. ease-out en 200ms se siente más rápido que ease-in en 200ms.

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

--ease-out-soft: cubic-bezier(
  0.22,
  1,
  0.36,
  1
); /* Token de Core; ease-out fuerte para UI */
--ease-in-out-soft: 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 drawer estilo iOS (Ionic) */

¿Necesitas una curva que no está aquí? Tómala de easing.dev o easings.co. No crees una manualmente.

Duración:

ElementoDuración
Feedback de pulsación de botónvar(--duration-press) (120ms)
Tooltips, popovers pequeñosvar(--duration-micro) (150ms)
Dropdowns, selectsvar(--duration-standard) (220ms)
Modalesvar(--duration-modal) (220ms)
Drawersvar(--duration-drawer) (320ms)
Marketing / explicativoPuede ser más largo

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

Opta por un spring cuando el movimiento sea arrastre con impulso, 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 en 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.
  • Springs para gestos, porque llevan la velocidad a través de una interrupción.
  • Sale 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.
  • Temporización asimétrica donde el usuario decide. Lento en la fase deliberada (una pulsación de mantener para confirmar: 2s lineal), rápido en la respuesta del sistema (liberación: 200ms ease-out).

7. Gating de movimiento reducido y puntero

Se incluye con la animación, cada vez.

@media (prefers-reduced-motion: reduce) {
  .element {
    animation: fade 0.2s ease;
  } /* mantén opacity/color, elimina el movimiento basado en transform */
}

@media (hover: hover) and (pointer: fine) {
  .element:hover {
    transform: scale(1.05);
  } /* el toque dispara 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 el movimiento y los cambios de posición.

Recetas

Para implementaciones listas para construir de los casos comunes — pulsación de botón, dropdown, tooltip, modal, drawer, 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 un archivo vacío.

Nunca Publicar

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

NuncaEn su lugar
transition: allNombra las propiedades exactas
transform: scale(0) entradascale(0.95) + opacity: 0
ease-in en un elemento UIease-out o una curva personalizada fuerte
ease-out integrado en una animación deliberadacubic-bezier(0.23, 1, 0.32, 1)
Animación en un atajo de teclado o acción 100+/díaSin animación
Duración UI superior a 300ms sin razón150–250ms
transform-origin: center en un popover anclado al desencadenantevar(--transform-origin) (modales exentos)
Keyframes en toasts, toggles, elementos activados rápidamenteTransiciones CSS
Animar width/height/margin/padding/top/lefttransform / opacity
Propiedades Motion x/y/scale bajo cargaCadena transform completa
Movimiento :hover sin gating@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 unas pocas líneas como máximo:

  • 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 spring, en una línea cada uno.
  • Qué verificar en sensación — si el resultado depende de la sensación que no puedes juzgar desde el código (un crossfade, el bounce de un spring, el balance de 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 vuelve a mirarlo al día siguiente.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

Asymmetric-al/core

Build animations for Expo and React Native only, using Reanimated, Gesture Handler, Expo Router, and expo-haptics. Use when the target runtime is an Expo or React Native app. Do not use it for Core Next.js web motion; use `animate` for web. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

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.

Asymmetric-al/core

Inspect a Core UI or code surface for a small number of justified motion opportunities and explicitly identify what should remain static. Use when asked what should animate, where motion would improve feedback or comprehension, how to make an interface feel more alive without over-animating it, or whether a proposed animation is worth adding. Read-only; do not use to review or fix existing motion code or to implement animations.

Asymmetric-al/core

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.

Asymmetric-al/core

Implement smooth, accessible animations with motion/react (Framer Motion) in React. Use when adding animations, gestures, or layout transitions with motion, AnimatePresence, useScroll, and related APIs. Requires a 'use client' boundary; not for strictly server-rendered components or when no animation is needed.

Asymmetric-al/core

Best practices for Remotion - Video creation in React

Asymmetric-al/core

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Skills relacionados