Communitygithub.com

antheo-motion

Decide si un elemento debe moverse, y asígnale el tiempo, la curva de aceleración y la distancia exactos (pulsaciones, hover, menús, diálogos, hojas, arrastres, transiciones de página), con soporte para movimiento reducido. Úsalo cuando la interfaz se sienta entrecortada, estática o exagerada, cuando un cajón o un arrastre se sientan mal, o antes de enviar cualquier animación.

¿Qué es antheo-motion?

Antheo Motion es una habilidad para agentes de IA (compatible con Claude Code, Cursor, Codex, etc.) que establece un sistema completo de animación para interfaces de usuario. Su propósito es convertir el movimiento en información significativa sobre cambios de estado, evitando tanto la falta de animación (saltos visuales) como el exceso de movimiento (ruido). La habilidad proporciona un marco de decisión basado en la frecuencia con que el usuario ve cada cambio: las acciones frecuentes (como escribir o mover el ratón) reciben movimientos mínimos (≤150ms, 4px), mientras que los eventos raros (como un primer éxito o un pedido realizado) pueden tener un momento destacado. Incluye una tabla de duraciones tokenizadas (`--dur-instant` a `--dur-page`), curvas de aceleración predefinidas, pares de apertura/cierre para componentes comunes, reglas estrictas sobre propiedades animables (solo `transform` y `opacity`), manejo de movimiento reducido (`prefers-reduced-motion: reduce`), y un proceso de verificación que incluye filmación a cámara lenta para analizar fotogramas. También cubre conceptos avanzados como escalonamiento, resortes físicos, arrastres, y auditorías completas de aplicación. La habilidad está acompañada de referencias detalladas en archivos como `recipes.md`, `why.md`, `gestures.md`, `springs.md`, `performance.md` y `habits.md`, y proporciona un script `filmstrip.mjs` para capturar y revisar animaciones.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/antheo-design/skills/tree/HEAD/skills/antheo-motion

Preguntar en tu IA favorita

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

Documentación

Antheo Motion

El movimiento es información sobre el cambio: algo llegó, se fue, se movió o te respondió. El movimiento que no explica nada es ruido; un cambio sin movimiento es un salto. Esta habilidad decide qué cambios se mueven y le da a cada uno su tiempo exacto. El momento emblemático de un componente pertenece a antheo-moment; los tokens de duración los genera antheo-tokens; el requisito de movimiento reducido lo comprueba antheo-access. Auditar, recortar o planificar el movimiento en toda una aplicación es tarea de antheo-motion-audit.

Decide en este orden

  1. Enumera cada cambio que hace la pantalla: qué se abre, cierra, aparece, desaparece, reordena, actualiza, carga, tiene éxito o falla.
  2. Marca con qué frecuencia lo ve una persona: muchas veces al día, a diario, o raramente.
  3. Asigna a cada uno su duración y curva de las tablas siguientes.
  4. Entrega el único evento raro y significativo, si lo hay, a antheo-moment.
  5. Compruébalo rápido, dos veces, y con movimiento reducido, luego grábalo y lee los fotogramas (abajo).

Nombra por qué se mueve, o no lo muevas

"Esto se mueve para que la persona entienda ___." ¿No puedes terminar la frase? Sin animación.

Cuanto más se ve, menos se mueve

FrecuenciaRecibe
Muchas veces al día (escribir, filas, pestañas, menús, una paleta)como máximo 150ms, 4px de recorrido; desde el teclado, solo un breve fundido
A diario (un diálogo, una hoja, un toast, un guardado)una breve llegada y una salida más rápida, de 150 a 300ms
Raramente (un primer éxito, un pedido realizado)el único lugar para un momento emblemático (antheo-moment)

Las duraciones, según la tarea

TokenValorSe usa en
--dur-instant100msfeedback de color y opacidad
--dur-fast150mspulsación, hover de entrada y salida, apertura de menú o tooltip
--dur-base200mscosas que desaparecen, cierre de diálogo, intercambio de valor o texto, llegada de un toast
--dur-open250msapertura de diálogo, pestañas, acordeón, redimensionamiento de tarjeta
--dur-slow300mselevación de una hoja o cajón, deslizamiento de un marcador
--dur-page400mstransición de página o de elemento compartido

El movimiento de la interfaz se mantiene en 300ms o menos; los movimientos de página en 400ms o menos. Los spinners, barras de progreso y animaciones vinculadas al scroll usan linear.

Abrir y cerrar, como pares

ElementoAbreCierra
Menú, popover, select150ms, desde scale(0.97) y fundido, en el disparador120ms
TooltipRetardo de 400ms, luego fundido de 150ms; inmediato si está dentro de 300ms de otro cierreinmediato
Diálogo250ms: elevación de 8px, fundido, escala desde 0.96200ms
Hoja, cajón300ms desde su borde, completamente opaco durante todo el proceso (sin fundido, sin desenfoque)200ms
Toast200ms, elevación de 12px200ms, sale por donde vino
Acordeón, revelación de altura250ms, grid-template-rows: 0fr a 1fr200ms

Nunca retrases un cierre o un hover-out: acorta la duración.

Una única curva para llegar y salir

--ease-out cubic-bezier(0.23, 1, 0.32, 1) para todo lo que entra o sale. --ease-in-out cubic-bezier(0.77, 0, 0.175, 1) solo para algo que se mueve de un lugar a otro en la pantalla. --ease-in solo para algo que se descarta definitivamente. Las salidas son más rápidas que las entradas y recorren aproximadamente la mitad de distancia.

Distancias pequeñas, nunca desde cero

Recorre 4px para un intercambio de valor o un popover, 8px para un diálogo, 12px para un toast, 24px para un elemento principal; el borde completo solo para una hoja. Entra desde scale(0.96) (0.97 para menús, 0.98 para tooltips) con opacidad 0, nunca desde scale(0). Desenfoque de 4px en un intercambio de texto o icono, 8px en una superficie grande, 2px en un fundido cruzado de menos de 200ms.

Qué puede animarse

transform y opacity (y color) por defecto; un desenfoque filter corto, clip-path y grid-template-rows para revelaciones de altura cuando sea necesario. Nunca transition: all, nunca width, height, top, left o margin, nunca box-shadow en sí mismo: pon una sombra cambiante en un pseudoelemento y desvanécela. will-change solo después de que un perfil lo solicite.

Crece desde el disparador

Los menús y popovers toman su transform-origin en el disparador (Radix expone --radix-popover-content-transform-origin); un modal permanece centrado; una hoja viene desde el borde en el que vive; un elemento compartido (una tarjeta que se abre en su página) usa un view-transition-name en cada lado.

Transiciones para estado, keyframes para un solo uso

Cualquier cosa que una persona pueda alternar usa una transición CSS o un resorte, que se invierten a medio vuelo; keyframes solo para cosas que se reproducen una vez.

Escalonamiento de 30 a 40ms, los primeros ocho, 300ms en total

De 60 a 80ms para las tres a seis partes de un elemento principal. Nunca escalones algo que se abre con frecuencia, y nunca bloquees un clic mientras los elementos llegan.

Resortes solo donde una mano lo mueve

Una perilla de interruptor, un arrastre soltado, una píldora segmentada que se desliza. Rebote de 0 a 0.2 en controles (el rebasamiento se mantiene dentro de la pista), hasta 0.45 para una celebración rara; como máximo un bamboleo. Un arrastre sigue al dedo sin transición y, al soltarlo, salta desde la velocidad de liberación; una hoja se cierra con un movimiento rápido mayor a aproximadamente 0.11px por ms, o una vez que ha recorrido min(64px, 15%) de su altura; de lo contrario, vuelve a su lugar (references/gestures.md).

Nada salta

Cada valor que cambia se ve cambiar; una fila eliminada cierra su espacio; se reserva espacio para lo que aparece (desplazamiento del layout menor a 0.1). Al cargar, como máximo una entrada. Cambia de temas con las transiciones desactivadas durante un fotograma.

Movimiento reducido mantiene la historia en fundidos

Con prefers-reduced-motion: reduce, el recorrido, la escala, el desenfoque, el paralaje y los rebotes se convierten en un fundido cruzado de opacidad de 150 a 200ms; una perilla de interruptor se mueve de inmediato; los bucles de reproducción automática se detienen. Cualquier cosa que se mueva por sí sola durante más de 5 segundos tiene un control de pausa (WCAG 2.2.2); nada parpadea más de 3 veces por segundo (2.3.1).

En toda una aplicación

  1. Encuentra: una tabla de cada cambio, con qué frecuencia se ve, cómo se mueve ahora, cómo debería.
  2. Mejora: tokens para cada número, las salidas que faltan, origen en el disparador, un patrón a la vez.
  3. Elimina: cualquier cosa que se anime en cada carga, se reproduzca en una acción de varias veces al día, retrase la siguiente acción, haga bucles mientras la gente lee, o supere los 300ms en una acción rutinaria. Cuando tengas dudas, elimínalo.
  4. Aprueba o bloquea: una frase de motivo, solo tokens, solo las propiedades permitidas, una salida más rápida que la entrada, movimiento reducido manejado, visto a velocidad normal y con ralentización de CPU 4×.

Compruébalo

Haz clic en todo rápido, dos veces: se invierte, nunca salta. Abre el menú veinte veces: sigue siendo rápido. Acelera la CPU 4×: sigue siendo suave. Activa el movimiento reducido: nada viaja.

Míralo: una imagen fija no puede juzgar el movimiento

Una captura de pantalla del estado de reposo no dice nada sobre cómo se mueve algo, y cada revisor lee fotogramas fijos. Así que graba cada movimiento que hiciste y mira los fotogramas antes de darlo por terminado:

node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".tuner" --click ".preset" --duration 600
node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".sheet" --drag ".handle" --by 0,240 --duration 900

Ralentiza la página a 0.1× (CSS, Web Animations y el reloj de JavaScript), hace la única acción y coloca 12 fotogramas del elemento en una sola hoja, cada uno con su tiempo. Abre la hoja y lee cada fotograma:

  • cada fotograma se ve compuesto por sí mismo: ningún borde duro deslizándose, ningún destello del color incorrecto, ninguna caja vacía
  • cada valor que cambia se ve cambiar: un número que debería rodar no salta mientras su aguja aún viaja
  • nada se refluye o salta a mitad de camino; el primer fotograma ya responde a la pulsación
  • el final se asienta donde debe: un resorte rebasa un poco y vuelve, un control no se detiene en seco
  • grábalo de nuevo con --reduce y --dark: la historia aún se cuenta, y el modo oscuro no tiene destello de luz

Arregla lo que muestra un fotograma, grábalo de nuevo y guarda la última hoja como evidencia.

Lo que la IU generada hace mal aquí

Revisa cada uno en references/habits.md antes de darlo por terminado: transition: all · contenido oculto hasta que un script lo revela · un restablecimiento general de movimiento reducido · un anillo de enfoque que se desvanece o desliza · movimiento que tiene rendimiento · efectos hover en cosas que no son clicables · una transición que lee un nombre que nadie definió.

Cuándo es correcto más movimiento

Las reglas de propósito y frecuencia deciden; los números son valores por defecto. Un juego, una herramienta creativa, un producto educativo o un momento de marca que la persona solicitó pueden moverse más y durante más tiempo. Aun así, responde inmediatamente a la entrada, nunca bloquea la siguiente acción, puede interrumpirse a mitad de camino, respeta el movimiento reducido y muestra su costo: un fotograma lento en un teléfono de gama media es un hallazgo, independientemente del estilo.

Terminado

  • Cada cambio enumerado con la frecuencia con que se ve; los frecuentes apenas se mueven; las acciones de teclado no viajan
  • Duraciones y curvas de aceleración de los tokens; los pares de apertura y cierre de arriba; sin cierres retrasados
  • Solo las propiedades permitidas; origen en el disparador; nada desde scale(0)
  • El movimiento reducido se convierte en un fundido cruzado; los bucles de más de 5s se pueden pausar
  • Se hizo clic rápido dos veces, con ralentización 4× y con movimiento reducido
  • Cada movimiento filmado (scripts/filmstrip.mjs), cada fotograma leído, claro, oscuro y reducido
  • Verificado contra cada hábito en references/habits.md

Archivos

  • scripts/filmstrip.mjs: graba un movimiento a 0.1× en una hoja de fotogramas, con el tiempo debajo de cada uno
  • references/recipes.md: el índice de 36 recetas listas para copiar, un archivo cada una en references/recipes/, desde pulsación y popover hasta rodamientos de números y texto en streaming
  • references/why.md: la razón detrás de cada regla, para cuando un valor parece arbitrario o alguien quiere romperla
  • references/gestures.md: arrastre, deslizamiento, hojas, puntos de ajuste, impulso, banda elástica (sensación de teléfono: antheo-mobile)
  • references/choreography.md: varias cosas como un solo cambio: cierre de espacios, reordenaciones, redimensionamiento de paneles, fundidos cruzados
  • references/springs.md: resortes en palabras sencillas, preajustes, un resorte JS de 30 líneas, linear() con alternativas
  • references/performance.md: qué es barato de animar, 60fps en un teléfono barato, cómo perfilar
  • references/advanced.md: 3D, animación impulsada por scroll, View Transitions, grabación de movimiento
  • references/vocabulary.md: descripciones sencillas a nombres de patrones a recetas
  • references/motion-kit.css: la copia de respaldo del motion.css generado
  • references/habits.md: lo que la IU generada hace mal aquí, cada uno con su solución

Skills relacionados