Communitygithub.com

Motion Match: medir, reconstruir y comparar animaciones

Convierte cualquier video, GIF o captura de pantalla de referencia en medidas precisas de movimiento y lo reconstruye en el mismo diseño del usuario, verificando si las animaciones coinciden fotograma a fotograma.

¿Qué es Motion Match: medir, reconstruir y comparar animaciones?

Este skill es la herramienta definitiva para desarrolladores y diseñadores que quieren medir y replicar animaciones a partir de cualquier referencia visual (video, GIF, grabación de pantalla). Analiza cada elemento móvil: tiempo, duración, easing, overshoot, recorrido, rotación y cambios de forma, y luego reconstruye el movimiento en cualquier plataforma (CSS, API de Web Animations, Framer Motion, GSAP, Remotion, SwiftUI, After Effects). Usa scripts Python propios con ffmpeg y numpy para extraer fotogramas, rastrear movimiento, calcular easing y comparar resultados con una tolerancia de ±0.08 segundos. Además, cuenta con tres modos especiales: Director, para crear animaciones desde imágenes fijas (interfaces, carteles); Story, para reels y piezas explicativas; y Edit, para segmentar videos largos (UGC, generados por IA) en anuncios. El resultado es un informe detallado con tablas de comparación, imágenes de actividad y hojas de contacto, y un archivo `spec.md` que se usa como checklist de verificación.

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

Preguntar en tu IA favorita

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

Documentación

Motion Match: medir cualquier animación, reconstruirla, demostrar que se mueve igual

Convierte "haz que se mueva así" en números: cada corte, y para cada elemento móvil su inicio, duración, easing, overshoot, recorrido, rotación y cambio de forma. Reconstruye el movimiento en la herramienta que use el usuario (CSS, la API de Web Animations, Framer Motion, GSAP, Remotion, SwiftUI, After Effects), luego compara fotograma a fotograma hasta que los tiempos coincidan dentro de ±0.08 s. ¿Sin movimiento de referencia, solo imágenes fijas? Usa el Modo Director (más abajo) para entradas de UI y el Modo Historia para reels y piezas explicativas: Claude diseña el movimiento, lo construye y luego mide su propia representación con los mismos scripts, así que "suave" se verifica, no se afirma. ¿Videoclips para cortar en un anuncio (UGC, generados por IA, filmados)? Usa el Modo Edición: las mismas medidas, reglas de Director y revisión, aplicadas al metraje. Métodos adaptados de NiazMorshed2007/reanimate y rossark0/rossark-motion-skill (ambos MIT); los scripts son propios.

<skill> es la carpeta de este skill. El trabajo va en ./motion-match/<nombre>/ en la carpeta actual: ref/ (desglose de referencia), ours/ (desglose de nuestra representación), compare-N/ (cada ronda de comparación), spec.md.

Configuración (primera vez)

Requiere ffmpeg/ffprobe en el PATH y un Python 3 con numpy y Pillow.

  • Comprobar: python3 -c "import numpy, PIL". Si falla, busca un Python que los tenga (un venv de proyecto existente); de lo contrario, pregunta al usuario una vez, luego: python3 -m venv ~/.motion-match/venv && ~/.motion-match/venv/bin/pip install numpy pillow y usa ~/.motion-match/venv/bin/python como python abajo. Ejecuta cada script con -I.
  • El Modo Director y Modo Historia también renderizan páginas sin interfaz gráfica: pip install playwright && python -m playwright install chromium (preguntar una vez). Si no se puede instalar, graba la pantalla de la página y menciona que los tiempos son menos exactos.
  • No hay otras instalaciones; no se sube nada a ningún sitio.

0. Alcance (escribirlo al inicio de spec.md antes de medir)

  • Objetivo: el archivo + rango de tiempo (+ recorte) exactamente como lo pidió el usuario ("los primeros 3 s", "solo el botón").
  • Fidelidad: fiel al movimiento (por defecto): orden, tiempo (±0.08 s), familia de easing, overshoot, recorrido relativo al tamaño del elemento, escalonamiento. El arte, colores, fuentes y palabras del usuario. Fiel al píxel solo cuando el usuario lo solicite y solo para práctica privada: el diseño, logotipo, personajes y música de otra persona son suyos; nunca ayudar a publicar una copia de ellos.
  • Destino: la herramienta o código donde va el movimiento (pregunta una vez si no está claro: decide el formato de salida).
  • Obtener la referencia: un archivo que el usuario proporciona, o una grabación de pantalla que hagan (sitios web y aplicaciones: grabar la interacción; el skill trabaja a partir de fotogramas, no del código del sitio). Descargar de YouTube u otro sitio solo cuando el usuario lo pida para ese video específico, en su propia carpeta; tratarlo como material de referencia privado.

1. Desglosarlo

python -I <skill>/scripts/ref_frames.py REF.mp4 --out motion-match/<nombre>/ref [--start S --end E --crop x:y:w:h] → cada fotograma a la fps de origen, sheets/timing_NN.png (cada fotograma: tiempo, easing, seguimiento) y sheets/poses.png (2 por segundo: lo que sucede). Lee todas las hojas. Los GIF funcionan igual.

2. Medir

  • Cortes y secciones: python -I <skill>/scripts/motion_compare.py motion-match/<nombre>/ref motion-match/<nombre>/ref --out motion-match/<nombre>/self --no-align lista los cortes de la referencia (cambios de escena) y movimientos con sus tiempos. Las referencias que nunca se quedan quietas se dividen en sus cortes.
  • Colores exactos: python -I <skill>/scripts/track_motion.py <ref>/frames --sample X,Y --at T (coordenadas de píxel del fotograma a tamaño completo, no de una hoja de contactos).
  • Cada elemento en movimiento: track_motion.py <ref>/frames --name btn --colors HEX,HEX --tol 35 --region x,y,w,h [--save-masks] (o --not-bg HEX para "todo lo que no sea el fondo"). En referencias brillantes o complejas, siempre proporciona un --region y colores exclusivos del elemento; verifica que el rango visible impreso tenga sentido. Registra posición (cx cy), tamaño (w h), compresión (aspect), bordes, desvanecimientos/crecimiento (presence), color y rotación (angle) por fotograma.
  • Cada movimiento: python -I <skill>/scripts/fit_easing.py <ref>/track_btn.json --prop cy --from A --to B (un movimiento por ventana, nunca a través de un corte) → inicio, fin, duración en ms y fotogramas, familia de easing, overshoot, tiempo de estabilización y líneas listas para pegar para CSS, WAAPI, Framer Motion, GSAP y Remotion. Error ≤ 0.03 es un ajuste cercano; "ningún easing simple se ajusta" significa dividir la ventana, o es una cadena de poses (fotogramas clave).
  • El movimiento pequeño (una compresión del 2%, un flotador de 5 px) no se muestra en las hojas pero sí en los números de seguimiento: léelos.
  • El texto que se desvanece en pequeño se acerca al ruido de la curva de actividad: mídela con track_motion en su lugar.

Qué números miden qué tipo de movimiento

movimientomedir connotas
mover, deslizar, flotarcx, cyun eje por ajuste
escalar, crecer, comprimirw, h, aspect
desvanecerpresence (con --colors)
rotación, giroangle (grados, sentido horario +, continuo más allá de 360)desde la silueta; None para círculos: rastrea una marca sobre ellos como elemento propio y ajusta su cx/cy. Las formas con simetría n-doble (cuadrado: 4) necesitan < 180/n grados por fotograma, así que los giros rápidos necesitan una fuente de alta fps. Otras formas del mismo color en la región lo estropean: estrecha --region
morfismo (forma → forma)--save-masks, luego shape_compare.pyver abajo
giro 3D / vuelta de cartaw (se encoge como coseno) + presence; cambio de color en el punto mediola cara posterior es su propio elemento
movimiento en trayectoria (arco, curva)tanto cx como cy, más angle si gira a lo largo de la trayectoriaajusta cada eje; la forma de la trayectoria está en las hojas
revelado de clip / máscara, cortinillax1 o y1 (el borde delantero), w/h
dibujo linealpresence
división de texto (por palabra/letra)rastrea la primera y la última palabra; el escalonamiento es su diferencia de inicio ÷ (cantidad − 1)
contadores, barras de gráficosbarras: h/y0; números: las hojas (a ojo)

Morfismos. track_motion.py ... --name blob --save-masks guarda la silueta de cada fotograma (centrada, escalada a igual área). Luego:

  • python -I <skill>/scripts/shape_compare.py <ref>/track_blob_masks.npz --from A --to B añade una serie morph (0 = primera forma, 1 = última) a track_blob.json. fit_easing.py ... --prop morph da entonces su inicio, fin y duración. El progreso del morfismo sigue el área, por lo que sus tiempos son fiables, pero su nombre de easing no es un valor para pegar: toma la facilidad de la especificación o de un parámetro que puedas rastrear (w, aspect, angle).
  • Nuestro vs la referencia: shape_compare.py REF_masks.npz --vs OURS_masks.npz --from A --to B [--rotate] → trayectoria de forma: si cada forma intermedia de la referencia también está en la nuestra, independientemente de su tiempo (PASS: media ≤ 10%, peor ≤ 25% de todo el morfismo). Luego fit_easing.py REF_TRACK --prop morph --vs OUR_TRACK comprueba el tiempo. --rotate ignora la rotación cuando el morfismo también gira (verifícalo con angle).

3. Escribir la especificación del movimiento (spec.md; cada fila se convierte en una comprobación)

| # | elemento | propiedad | de → a | inicio s | dur s (fotogramas) | easing | overshoot | escalonamiento / notas | fuente |
| 1 | tarjeta | translateY | 40 → 0 px | 0.20 | 0.60 (18) | easeOutCubic / cubic-bezier(.33,1,.68,1) | 0% | +0.08 s por tarjeta | track + fit_easing |
| 2 | icono | rotate | 0 → 180 deg | 0.40 | 0.30 (9) | easeOutCubic | 0% | — | track angle + fit_easing |
| 3 | blob | morph | cuadrado → círculo | 0.50 | 0.40 (12) | easeInOutCubic | — | forma trayectoria PASS | shape_compare |
| c | — | cortes | — | 1.77, 2.33 | — | — | — | — | motion_compare self |

Un "?" en una fila significa que los fotogramas aún no se han leído. Anota también lo que no se mueve. Muestra la especificación al usuario antes de construir cuando el trabajo es grande.

4. Construir

En la herramienta del usuario, con su diseño. Copia los tiempos de la especificación y los easings del ajustador para esa herramienta. Mapa las distancias relativas al elemento o al fotograma cuando el diseño difiera. Cadenas de poses: fotogramas clave con interpolación suave y sin overshoot; resortes donde la referencia sobrepasa y se estabiliza.

  • Rotación: establece transform-origin explícitamente (mide el pivote: el punto cuyo cx, cy permanece quieto).
  • Morfismos: las rutas SVG necesitan el mismo número y tipo de comandos en ambos extremos (o usa flubber / GSAP MorphSVG); los morfismos de diseño de UI (botón → tarjeta, miniatura → página) usan FLIP o transiciones de elemento compartido (Framer layoutId, la API de View Transitions); los morfismos de tamaño/radio de esquina son CSS simple.
  • 3D: perspective 800–1200 px en el padre, backface-visibility: hidden, ambas caras como capas separadas.

5. Comparar y corregir (2-5 rondas)

  1. Renderizar o grabar la pantalla de la nuestra sobre la misma ventana a la misma fps (grabar una página web de la misma manera que la referencia).
  2. ref_frames.py OURS.mp4 --out motion-match/<nombre>/ours --like motion-match/<nombre>/ref/frames.json (misma ventana, recorte, fps y tamaño de fotograma).
  3. motion_compare.py motion-match/<nombre>/ref motion-match/<nombre>/ours --out motion-match/<nombre>/compare-N → desplazamiento, cada corte y movimiento con errores de inicio/fin/duración/pico, PASS dentro de ±0.08 s, activity.png (ambas curvas) y sheets/compare_NN.png (referencia | nuestra | diferencia). Lee las hojas cada ronda.
  4. Por fila de especificación: rastrea la nuestra de la misma manera, luego fit_easing.py REF_TRACK --prop P --from A --to B --vs OUR_TRACK → PASS/FAIL de tiempo por movimiento, coincidencia de recorrido y familia de easing. Filas de morfismo: shape_compare.py --vs también.
  5. Corrige lo más pequeño que la evidencia señale, vuelve a representar, repite. Después de 5 rondas, informa de cualquier cosa que aún falle con sus números y el motivo. Nunca aflojes la tolerancia en silencio.
SíntomaCausa habitualCorrección
todo desplazado por un desplazamientoretardo de inicio o latencia de activaciónajusta el primer retardo
la nuestra más corta y cargada al inicioeasing demasiado fuerte (expo vs cubic)usa el bezier ajustado
la referencia sobrepasa, la nuestra nomuelle/back vs easing simpleback.out / un muelle ajustado al overshoot medido
un movimiento en la nuestra se detiene tempranofalta un movimiento secundario (una deriva, un empujón)mira las hojas en esa ventana
un movimiento o corte extra en la nuestraalgo se anima que en la referencia está quietoelimínalo o retrasalo
los números de elemento saltanel seguimiento atrapó otro elementoestrecha --region, usa colores exclusivos para él
el recorrido de rotación correcto, pero la nuestra oscila en cx/cytransform-origin incorrectomueve el pivote al punto quieto medido
tiempo de morfismo PASS, trayectoria de forma FAILlas rutas interpolan de manera diferente (orden de puntos, punto de inicio)reordenar puntos de ruta / emparejar comandos; usa una biblioteca de morfismo

6. Informe

Fidelidad; qué se ha coincidido y qué es propio del usuario; la última tabla de comparación (cortes y movimientos con errores, PASS/FAIL); filas por elemento; rutas a activity.png y las hojas de comparación; cada diferencia restante con su número y motivo; y qué comprobaciones fueron medidas (un script las produjo) vs estimadas a ojo (mira una hoja).

Modo Director: una imagen fija, movimiento diseñado para ella

Úsalo cuando el usuario proporcione una imagen (captura de pantalla de UI, maqueta, póster, foto de producto) sin movimiento de referencia, o pida a Claude que elija el movimiento. El trabajo va en ./motion-match/<nombre>/ como de costumbre (ours/, spec.md, check-N/). Para una pieza de video en lugar de una entrada de UI, sigue estos pasos dentro del Modo Historia (más abajo).

  1. Lee la imagen. Enumera cada elemento (fondo, navegación, titular, cuerpo, imagen, CTA, tarjetas, iconos) con su caja en px, su función y su rango: un punto focal, luego de apoyo, luego cromo. Anota el orden de lectura, los grupos (una fila de tarjetas, una lista), el estado de ánimo (tranquilo/premium, neutral/producto, divertido) y cualquier cosa que sugiera un movimiento especial (un icono de conmutación, un gráfico, una marca de logotipo, una trayectoria curva, una tarjeta que se puede voltear).
  2. Elige una personalidad del estado de ánimo a menos que el usuario nombre una. Cuando pidan opciones, construye las tres.
personalidadentradaduracióneasingrecorridoescalonamientoovershoot
tranquilodesvanecer + subir400–600 mseaseOutQuart / cubic-bezier(.25,1,.5,1)8–16 px60–80 msninguno
neutraldesvanecer + subir, o escala .97→1250–400 mseaseOutCubic / cubic-bezier(.33,1,.68,1)12–24 px40–60 msninguno
divertidosubir + escala .9→1muellemuelle (rigidez 300–400, amortiguación 20–26)16–32 px50–70 ms3–8%
  1. Elige movimiento especial por función (el vocabulario; los valores son puntos de partida, escalados por personalidad):
movimientoúsalo paravalores predeterminados
morfismoconmutación de iconos (menú ↔ cerrar, reproducir ↔ pausar), un botón que se expande en una tarjeta o hoja, un logotipo de forma300–500 ms easeInOutCubic; morfismos de diseño vía FLIP/elemento compartido
rotacióniconos de conmutación/chevron, actualizar, una entrada inclinadaicono 90–180° en 200–300 ms easeOutCubic; entrada −6…−10° → 0 con el easing de la personalidad; cargador 360° lineal 0.8–1.2 s bucle
giro 3D / inclinacióntarjetas con dos caras, conmutaciones de precios, profundidad al pasar el ratóngiro rotateY 180° en 500–700 ms easeInOutCubic; inclinación al pasar el ratón ≤ 8°
movimiento en trayectoriaalgo que viaja (un avión, un punto a lo largo de una ruta, un cursor)easeInOutSine, giros a lo largo de la trayectoria, 0.8–1.6 s
revelado de clip / máscaraimágenes principales, grandes titularesclip inset o círculo, 500–800 ms easeOutQuart
división de textosolo el titular principalpalabras separadas 40–60 ms, letras 15–30 ms; línea completa ≤ 1 s
dibujo linealiconos, firmas, gráficos, subrayadosstroke-dashoffset, 600–1000 ms easeInOutCubic
contadores / crecimiento de gráficosnúmeros, barras, anillosnúmeros 800–1200 ms easeOutExpo; barras desde la línea base, escalonadas 40–60 ms
paralaje / profundidadhéroes en capas, escenas de desplazamientovelocidades de capa 0.2–0.6 del desplazamiento; líneas de tiempo de desplazamiento donde se admitan
  1. Coreografía según estas reglas:
    • Orden: fondo/contenedor → punto focal → titular → apoyo → CTA. Cromo (navegación) último, o primero como un rápido desvanecimiento de 150 ms si enmarca la página.
    • El tamaño establece la duración (iconos en el rango bajo

…

[truncado para la traducción]

Skills relacionados