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 pillowy usa~/.motion-match/venv/bin/pythoncomopythonabajo. 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-alignlista 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 HEXpara "todo lo que no sea el fondo"). En referencias brillantes o complejas, siempre proporciona un--regiony 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_motionen su lugar.
Qué números miden qué tipo de movimiento
| movimiento | medir con | notas |
|---|---|---|
| mover, deslizar, flotar | cx, cy | un eje por ajuste |
| escalar, crecer, comprimir | w, h, aspect | |
| desvanecer | presence (con --colors) | |
| rotación, giro | angle (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.py | ver abajo |
| giro 3D / vuelta de carta | w (se encoge como coseno) + presence; cambio de color en el punto medio | la 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 trayectoria | ajusta cada eje; la forma de la trayectoria está en las hojas |
| revelado de clip / máscara, cortinilla | x1 o y1 (el borde delantero), w/h | |
| dibujo lineal | presence | |
| 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áficos | barras: 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 Bañade una seriemorph(0 = primera forma, 1 = última) atrack_blob.json.fit_easing.py ... --prop morphda 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). Luegofit_easing.py REF_TRACK --prop morph --vs OUR_TRACKcomprueba el tiempo.--rotateignora la rotación cuando el morfismo también gira (verifícalo conangle).
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-originexplícitamente (mide el pivote: el punto cuyocx, cypermanece 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:
perspective800–1200 px en el padre,backface-visibility: hidden, ambas caras como capas separadas.
5. Comparar y corregir (2-5 rondas)
- 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).
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).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) ysheets/compare_NN.png(referencia | nuestra | diferencia). Lee las hojas cada ronda.- 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 --vstambién. - 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íntoma | Causa habitual | Corrección |
|---|---|---|
| todo desplazado por un desplazamiento | retardo de inicio o latencia de activación | ajusta el primer retardo |
| la nuestra más corta y cargada al inicio | easing demasiado fuerte (expo vs cubic) | usa el bezier ajustado |
| la referencia sobrepasa, la nuestra no | muelle/back vs easing simple | back.out / un muelle ajustado al overshoot medido |
| un movimiento en la nuestra se detiene temprano | falta un movimiento secundario (una deriva, un empujón) | mira las hojas en esa ventana |
| un movimiento o corte extra en la nuestra | algo se anima que en la referencia está quieto | elimínalo o retrasalo |
| los números de elemento saltan | el seguimiento atrapó otro elemento | estrecha --region, usa colores exclusivos para él |
el recorrido de rotación correcto, pero la nuestra oscila en cx/cy | transform-origin incorrecto | mueve el pivote al punto quieto medido |
| tiempo de morfismo PASS, trayectoria de forma FAIL | las 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).
- 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).
- Elige una personalidad del estado de ánimo a menos que el usuario nombre una. Cuando pidan opciones, construye las tres.
| personalidad | entrada | duración | easing | recorrido | escalonamiento | overshoot |
|---|---|---|---|---|---|---|
| tranquilo | desvanecer + subir | 400–600 ms | easeOutQuart / cubic-bezier(.25,1,.5,1) | 8–16 px | 60–80 ms | ninguno |
| neutral | desvanecer + subir, o escala .97→1 | 250–400 ms | easeOutCubic / cubic-bezier(.33,1,.68,1) | 12–24 px | 40–60 ms | ninguno |
| divertido | subir + escala .9→1 | muelle | muelle (rigidez 300–400, amortiguación 20–26) | 16–32 px | 50–70 ms | 3–8% |
- Elige movimiento especial por función (el vocabulario; los valores son puntos de partida, escalados por personalidad):
| movimiento | úsalo para | valores predeterminados |
|---|---|---|
| morfismo | conmutación de iconos (menú ↔ cerrar, reproducir ↔ pausar), un botón que se expande en una tarjeta o hoja, un logotipo de forma | 300–500 ms easeInOutCubic; morfismos de diseño vía FLIP/elemento compartido |
| rotación | iconos de conmutación/chevron, actualizar, una entrada inclinada | icono 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ón | tarjetas con dos caras, conmutaciones de precios, profundidad al pasar el ratón | giro rotateY 180° en 500–700 ms easeInOutCubic; inclinación al pasar el ratón ≤ 8° |
| movimiento en trayectoria | algo 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áscara | imágenes principales, grandes titulares | clip inset o círculo, 500–800 ms easeOutQuart |
| división de texto | solo el titular principal | palabras separadas 40–60 ms, letras 15–30 ms; línea completa ≤ 1 s |
| dibujo lineal | iconos, firmas, gráficos, subrayados | stroke-dashoffset, 600–1000 ms easeInOutCubic |
| contadores / crecimiento de gráficos | números, barras, anillos | números 800–1200 ms easeOutExpo; barras desde la línea base, escalonadas 40–60 ms |
| paralaje / profundidad | héroes en capas, escenas de desplazamiento | velocidades de capa 0.2–0.6 del desplazamiento; líneas de tiempo de desplazamiento donde se admitan |
- 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]