Communitygithub.com

Motion UI

Muestra al agente cómo planificar, construir o recortar «motion UI» para que el resultado concreto sea un pase de sistema de diseño con tokens. El procedimiento recorre Motion UI, Flujo de trabajo y No negociables. Úsalo cuando una nueva tarea requiera esta disciplina.

¿Qué es Motion UI?

Esta habilidad proporciona un manual de referencia basado en investigación para implementar movimiento y gestos en interfaces de usuario de producto. Incluye 19 archivos de patrones, cada uno con reglas, antipatrones, referencias buenas y malas, accesibilidad, tokens, un bosquejo de implementación y una lista de verificación. El archivo SKILL.md central contiene el flujo de trabajo, los no negociables, las tablas de decisión y los valores predeterminados de los tokens. La habilidad es útil para desarrolladores que usan plataformas como Claude Code, Cursor o Codex, ya que guía al agente a través de un proceso sistemático de 9 pasos: desde decidir si un elemento debe animarse, seleccionar el mecanismo adecuado (transiciones CSS, muelles JS, View Transitions, animaciones basadas en scroll), configurar la temporización con tokens, hasta revisar el resultado con una rúbrica de 18 puntos. Soporta tanto CSS como bibliotecas de JavaScript como Motion o React Spring, y hace hincapié en la accesibilidad, el rendimiento (animar solo transform y opacidad) y el cumplimiento de los no negociables documentados.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehudaBriskman/fUdesIgn/tree/HEAD/plugins/motion-ui/skills/motion-ui

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Motion UI?

Un manual basado en investigación para el movimiento y los gestos en la interfaz de usuario de producto: 19 archivos de patrones, cada uno con reglas, antipatrones, referencias buenas y malas, accesibilidad, tokens, un bosquejo de implementación y una lista de verificación. Este archivo proporciona el flujo de trabajo, los no negociables, las tablas de decisión y los valores predeterminados de los tokens. Abre los archivos de patrón para obtener profundidad.

  • Índice de patrones: references/INDEX.md enumera cada patrón con su regla de una línea.
  • Archivos de patrón: references/patterns/<prefijo>-<nombre>.md. Los prefijos son mfound (propósito, temporización, coreografía, movimiento reducido), mspring (muelles), mgesture (arrastre, impulso, bordes, paneles, interrupción), mtrans (entrada/salida, origen espacial, transiciones de ruta, microinteracciones, animaciones basadas en scroll), mperf (rendimiento) y mref (rúbrica de revisión, antipatrones).
  • Tokens de inicio: assets/motion-tokens.css. Los nombres y valores de duración, easing y retardo coinciden con tokens.css de dashboard-ui. Funciona por sí solo en modo claro y oscuro: los tokens de rol de dashboard-ui que lee se declaran con especificidad cero, por lo que tokens.css de dashboard-ui o los tokens propios del proyecto con los mismos nombres de rol los anulan en cualquier orden de carga.
  • UI de datos: para interpolación de números, transiciones de gráficos, exploración enlazada, recálculo en vivo y estados de carga, usa los patrones motion-* y prog-* de dashboard-ui. Esta habilidad no los repite.

Flujo de trabajo

  1. Decide si debe moverse. Nombra el trabajo: retroalimentación, continuidad, orientación, atención o (rara vez) deleite. Estima con qué frecuencia ocurre y si se activa desde el teclado, luego elige la fila en la tabla de frecuencias a continuación (mfound-propósito-y-frecuencia.md). Si no hay trabajo, o la acción se activa por teclado u ocurre 100+ veces al día, detente: no hay animación.
  2. Elige el mecanismo.
    • De reposo a reposo y conmutado (menús, diálogos, conmutadores): una transición CSS (mfound-duraciones-y-easing.md), o un token de muelle linear() CSS (mspring-css-linear-y-tokens.md).
    • Impulsado por un dedo o puntero, o interrumpible con velocidad: un muelle JS (mspring-parámetros-y-mapeo.md, mgesture-interrumpibilidad-y-velocidad.md).
    • Navegación: View Transitions (mtrans-view-transitions-y-rutas.md).
    • Vinculado a la posición de scroll: animación basada en scroll (mtrans-animaciones-basadas-en-scroll.md).
  3. Establece la temporización a partir de los tokens. Duración por elemento, easing según la dirección, salidas a 0,75× la entrada, y muelles como duración más rebote. Nunca uses valores sin procesar en los componentes.
  4. Colócalo en el espacio. Usa transform-origin en el disparador, refleja las salidas, mantén la coherencia entre avance y retroceso, y deja que el chrome persistente permanezca quieto (mtrans-origen-espacial-y-continuidad.md). Para la entrada/salida de elementos en la capa superior, sigue mtrans-entrada-salida-capa-superior.md.
  5. Para gestos, aplica en orden:
    • Seguimiento 1:1 con un umbral de 10 px (mgesture-manipulación-directa-arrastre.md);
    • Proyección y velocidad al soltar (mgesture-impulso-proyección-y-snap.md);
    • Bordes con banda elástica (mgesture-banda-elástica-y-límites.md);
    • Las reglas de paneles y deslizamiento para descartar (mgesture-paneles-y-deslizar-para-descartar.md).
  6. Coreografía cuando cambian varias cosas: causa primero, luego padre, luego hijos; retardo de 20–40 ms, con límite (mfound-coreografía-y-retardo.md).
  7. Hazlo económico. Anima solo transform y opacidad, no uses will-change global, y pinta la retroalimentación en el siguiente frame (mperf-compositor-will-change-e-inp.md).
  8. Escribe la versión de movimiento reducido como sustituciones, no eliminaciones (mfound-movimiento-reducido-vestibular.md).
  9. Revisa a partir de frames.
    • Ejecuta la pasada de antipatrones (mref-galería-de-antipatrones.md).
    • Captura tiras de frames (ralentizado 4×, movimiento completo y reducido, además de una ejecución interrumpida) y la auditoría en página.
    • Puntúa la rúbrica de 18 comprobaciones (mref-rúbrica-de-revisión-de-movimiento.md). Publica con un 80% o más y sin ninguna comprobación obligatoria en 0.
    • Informa cada hallazgo como ID de comprobación · evidencia · corrección, además de lo que no comprobaste.

No negociables

Rompe uno de estos solo con una razón por escrito.

Si y cuánto tiempo

  1. Cada animación tiene un trabajo nombrado. Las acciones activadas por teclado y las de 100+/día no tienen animación.
  2. La primera respuesta visual llega dentro de los 100 ms posteriores a la entrada, independientemente de la duración de la animación.
  3. Las duraciones provienen de los tokens (100 / 150 / 240 / 400 ms). Nada en el chrome de la UI supera los 400 ms; solo los momentos raros pueden alcanzar los 600 ms.
  4. Las entradas se desaceleran; los movimientos en pantalla se aceleran y desaceleran; no hay ease-in en nada que el usuario espere. Las salidas son aproximadamente 0,75× la entrada.

Muelles y gestos

  1. Los muelles se escriben como duración + rebote. Usa rebote 0 para el chrome de la UI, 0,1–0,2 solo después de un gesto con impulso, y nunca en opacidad, color o valores de datos.
  2. Los elementos arrastrados siguen el puntero 1:1 desde el punto de agarre, sin transición durante el arrastre. Comprométete con un arrastre después de aproximadamente 10 px.
  3. Al soltar, ajusta al destino más cercano a la posición proyectada e inicia el muelle de asentamiento con la velocidad de liberación.
  4. Los bordes tienen banda elástica; nada se detiene bruscamente bajo el dedo.
  5. Todo lo que el usuario puede afectar es interrumpible desde su valor actual en pantalla. No hay colas de animación ni entrada bloqueada durante el movimiento. La UI conmutada usa transiciones, no keyframes.
  6. Las acciones gestuales destructivas se confirman al soltar y ofrecen deshacer. Cada gesto tiene un botón o equivalente de teclado (WCAG 2.5.7).

Entrada, salida y navegación

  1. Nunca comiences desde scale(0). Entra desde opacidad 0 más escala 0,95–0,97 o 8–24 px de desplazamiento, con transform-origin en el disparador.
  2. Usa @starting-style para la entrada y display/overlay con allow-discrete para la salida. El estado final visible es el predeterminado, por lo que los navegadores no compatibles aún funcionan.
  3. Las transiciones de ruta son mejora progresiva. Prepara los datos primero, luego transiciona. Usa el fundido cruzado predeterminado o un desplazamiento direccional de 16–24 px según el tipo de transición, nombra 1–3 elementos compartidos y mueve el foco después.
  4. Los toasts nunca contienen la única copia de la información. Los errores nunca se descartan automáticamente; un toast de Deshacer permanece al menos 8 s y su acción también existe fuera del toast. Los temporizadores se pausan al pasar el ratón, al enfocar y en pestañas ocultas (dashboard-ui/comp-notificaciones-alertas.md).

Rendimiento y seguridad

  1. Anima solo las propiedades de la familia transform y la opacidad en cualquier cosa más grande que un control pequeño. No hay transition: all. will-change es temporal y solo sigue a una medición.
  2. Bajo prefers-reduced-motion: reduce, reemplaza el movimiento espacial con un fundido de 150 ms o menos, mantén la retroalimentación, mantén el seguimiento de arrastre 1:1 y elimina el rebote. Nunca envíes un interruptor global 0.01ms, y la animación JS también debe respetar la configuración.
  3. Sin paralaje, secuestro de scroll, zoom de ventana completa o movimiento en bucle inactivo en la UI del producto. La reproducción automática de más de 5 s tiene un control de pausa, y nada parpadea más de 3 veces por segundo.
  4. Revisa el movimiento a partir de frames capturados, no del código o la memoria.

Tablas de decisión

Frecuencia → movimiento (mfound-propósito-y-frecuencia.md)

FrecuenciaMovimiento
Activado por teclado, o 100+ veces al día (límite de la habilidad)Ninguno
Decenas de veces al díaFundido de 100–150 ms, tal vez una pequeña escala; sin movimiento, sin rebote
Algunas veces por sesión150–240 ms, puede moverse 8–24 px
Raro (primera ejecución, gran éxito)Hasta 400–600 ms, un muelle con rebote permitido

Mecanismo (mspring-parámetros-y-mapeo.md, mspring-css-linear-y-tokens.md)

SituaciónUsar
Color, opacidad, cambio de estadoTransición CSS, linear o ease-out
Elemento conmutado que puede invertirse a medio caminoTransición CSS (nunca keyframes)
Movimiento espacial de reposo a reposo con sensación de muelleToken CSS spring linear() más su propia duración
Liberación después de arrastre o lanzamiento, o redireccionamiento con velocidadMuelle JS (Motion, React Spring, SwiftUI, Compose)
Cambio de diseño (reordenar, redimensionar, expandir)FLIP, Motion layout o una View Transition
Cambio de página o rutaView Transition (mismo o entre documentos)
Progreso a través de un scrollAnimación basada en scroll

Duración y easing por elemento (mfound-duraciones-y-easing.md)

ElementoDuraciónCurva
Pulsación, conmutación, hover100 msease-out (escala de pulsación 0,97)
Tooltip, menú, popover150 ms entrada / 110 ms salidaease-out entrada, ease-in o fundido salida
Diálogo, toast240 ms entrada / 180 ms salidaease-out entrada, ease-in o fundido salida
Panel, cajón240–400 ms--motion-ease-drawer o un muelle después de arrastre
Transformación de contenedor (tarjeta → detalle)400 msenfatizado
Fundido cruzado de ruta150–250 mslineal

Preajustes de muelles (mspring-parámetros-y-mapeo.md)

TokenDuración / reboteUsar
spring-fast0,24 s / 0Conmutadores, controles pequeños
spring-default0,3 s / 0Menús, asentamiento de panel, diseño
spring-slow0,45 s / 0Superficies de pantalla completa
spring-snappy0,3 s / 0,15Liberación después de un golpe, snaps
spring-playful0,4 s / 0,3Solo deleite raro

Los parámetros de las bibliotecas (Motion, React Spring, SwiftUI, Material 3) provienen de una fórmula en mspring-parámetros-y-mapeo.md.

Umbrales de gestos (mgesture-*)

ValorPredeterminado
Inicio de arrastre / bloqueo de eje10 px
Ventana de muestreo de velocidad100 ms
Desaceleración de proyección0,998 por ms (0,99 para paginación rápida)
Golpe confirmado> 400 px/s
Cierre de panel> 25% de su altura arrastrada, o un golpe
Constante de banda elástica0,55 (la aproximación común)

Valores predeterminados de tokens

Conjunto completo en assets/motion-tokens.css.

GrupoPredeterminados
Duracióninstant 0 · micro 100 · short 150 · medium 240 · long 400 ms · relación de salida 0,75
Easingestándar cubic-bezier(0.2,0,0.38,0.9) · entrada (0,0,0.38,0.9) · salida (0.2,0,1,0.9) · enfatizado (0.2,0,0,1) · cajón (0.32,0.72,0,1)
Muelles (CSS)--motion-spring-{fast,default,slow,snappy,playful} con -dur correspondiente (360 / 450 / 670 / 420 / 660 ms)
Geometríaescala desde 0,96 · pulsación 0,97 · distancia 8 / 16 / 24 px
Coreografíaretardo 30 ms · máximo 300 ms (150 ms en menús)
Movimiento reducidolos tokens espaciales se colapsan a 0 o 1; los fundidos mantienen su temporización

Cómo aplicar esta habilidad

  • Al construir:
    • Carga assets/motion-tokens.css o mapéalo a los tokens del proyecto.
    • Prefiere las funciones de la plataforma: transiciones CSS, @starting-style, <dialog> y la API popover, View Transitions, animaciones basadas en scroll, linear(). Recurre a una biblioteca JS solo para gestos y velocidad.
    • Nunca uses el tipo any de TypeScript.
  • Al revisar: captura los frames primero, luego ejecuta la galería de antipatrones y la rúbrica. Informa una tabla de comprobación, puntuación, evidencia y corrección, ordenada por gravedad, y enumera lo que no comprobaste.
  • Cuando el proyecto tiene un sistema de movimiento (M3, Carbon, sus propios tokens): sus tokens ganan. Mapéalos a estos roles y señala las brechas.
  • Cuando las reglas entren en conflicto: la accesibilidad y el control del usuario (movimiento reducido, interrumpibilidad, sin secuestro de scroll) vencen a la expresividad, y la frecuencia vence al deleite.

Individual skills in this repo

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

Skills relacionados