Communitygithub.com

mograf-review: la puerta del gusto

Crítico independiente y puerta de calidad para motion graphics. Evalúa una pieza de HyperFrames / GSAP / HTML (o Remotion) según una rúbrica de estudio de 9 dimensiones, comprueba puertas duras, un listón de artesanía de 12 puntos y la lista anti-sopor mirando realmente los fotogramas, y devuelve APROBAR / PULIR / RETRABAJAR con correcciones exactas a nivel de fotograma.

¿Qué es mograf-review: la puerta del gusto?

Este skill es un revisor de motion graphics autónomo y estricto que actúa como una puerta de calidad profesional. Está diseñado para ser ejecutado como un subagente con contexto fresco para que el creador nunca evalúe su propio trabajo. El skill analiza proyectos de HyperFrames, GSAP/HTML o Remotion siguiendo un procedimiento completo de 10 pasos que incluye: estructura (con npx hyperframes check), lectura de mapas de animación, creación de hojas de contacto con instantáneas en momentos clave, prueba de profundidad (con fantasmas o cámaras de prueba), visualización a velocidad real (con generación de tira de fotogramas), lectura de código (buscando eases concretos, non-determinismo, etc.), y puntuación en 9 dimensiones (concepto, composición, tipografía, timing, coreografía, transiciones, profundidad, sincronía de sonido, acabado). Además aplica 12 condiciones de artesanía y una lista anti-sopor de 15 señales de diseño genérico. El resultado final es un veredicto: APROBAR (media ≥ 4.0), PULIR (media 3.5–3.9) o RETRABAJAR (media < 3.5), acompañado de una tabla detallada de correcciones con valores exactos. Es útil para estudios de motion que quieran garantizar un estándar de calidad antes de cada entrega.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Parrass/mograf-public/tree/HEAD/plugins/mograf/skills/motion-review

Preguntar en tu IA favorita

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

Documentación

motion-review: la puerta del gusto

Los linters detectan código roto. Este skill detecta el gusto. Postura por defecto: señalar primero; la aprobación se gana. Una pieza que "se ve bien" obtiene un 3, y un 3 no se entrega.

Cómo ejecutarlo

  • Ejecútalo como un subagente nuevo cuando puedas. Dale: este archivo, la carpeta del proyecto y el brief. No le digas lo difícil que fue la construcción.
  • El revisor nunca edita la composición. Escribe review.md en la carpeta del proyecto y devuelve el veredicto.
  • Mira los píxeles, no solo el código. Cada puntuación debe apuntar a una marca de tiempo, fotograma o selector.
  • Un revisor por pieza. Dos revisores ejecutándose a la vez escriben el mismo review.md y sus veredictos entran en conflicto. Cada ronda termina con una línea verdict:; el llamador consulta review.md para obtenerla. Las revisiones repetidas van al mismo revisor; reemplázalo solo si review.md no muestra una nueva ronda tras una larga espera, anota la cancelación en review.md y haz que el reemplazo lea el historial primero. Si las rondas entran en conflicto, la última escritura en review.md es la autorizada.

Procedimiento

Ejecuta cada paso. Los comandos asumen un proyecto HyperFrames (npx hyperframes …); para otros stacks usa el equivalente (Remotion: npx remotion still para fotogramas, npx remotion render para la tira).

  1. Estructura. npx hyperframes check . Cualquier error es un Bloque. Lee también las advertencias. Su auditoría de contraste es la puerta de contraste. El texto decorativo que nunca se pretende leer (fantasmas borrosos, clones de estela fantasma, chips que se disuelven, relleno de mezcla) se excluye con data-layout-ignore en cada nodo; nunca lo uses para ocultar copia real.

  2. Mapa de movimiento. Lee el código de la línea de tiempo (o el mapa de animación, si tus habilidades de HyperFrames incluyen animation-map.mjs). Anota:

    • zonas muertas de 1 s o más sin nada en movimiento;
    • movimientos espaciales de menos de 0,2 s (demasiado rápidos para leer) o más de 2 s (a la deriva);
    • escalonamientos irregulares o mecánicos;
    • elementos que salgan del encuadre o choquen accidentalmente.

    El movimiento impulsado a través de un objeto proxy/setter (cámara personalizada, three.js, contadores) es invisible para los mapas basados en tweens; usa tiras de fotogramas (paso 5) para esos movimientos.

  3. Hoja de contactos. A partir del storyboard o la lista de beats, toma los tiempos de las escenas y las costuras. Captura:

    • fotograma 0, el momento héroe y el fotograma final;
    • 25 / 50 / 75 % de cada escena;
    • cada costura a −2 fotogramas, 0 y +2 fotogramas.

    npx hyperframes snapshot --at <t1,t2,…>. Pasa tiempos de fotograma exactos (t = fotograma / fps, p. ej. fotograma 316 a 30 fps → 10.5333); --at no ajusta, por lo que un tiempo redondeado muestra una pose intermedia que el render nunca contiene. snapshot deja PNGs obsoletos de ejecuciones anteriores, así que mueve el directorio snapshots/ anterior antes de cada ejecución (p. ej. node -e "require('fs').renameSync('snapshots','snapshots-'+Date.now())") en lugar de borrarlo con un glob rm; --at también puede añadir un fotograma extra que no pediste, ignora los extras. Abre las imágenes y mira. Haz zoom solo en el texto cuando el elemento sea visible (hacer zoom en un elemento oculto puede colgarse).

  4. Prueba de profundidad. Para movimientos de cámara o héroe, npx hyperframes keyframes --ghost --angle. Los planos que se separan a lo largo de z significan profundidad real; todo escalándose junto significa profundidad falsa. El espaciado uniforme de fantasmas en un movimiento héroe significa easing lineal, que falla. Si --ghost no puede ejecutarse, toma una copia de prueba y dale al padre del mundo una cámara de prueba (empujar hacia atrás + inclinación + guiñada, p. ej. translateZ(-900px) rotateX(-28deg) rotateY(64deg); solo guiñada pone la cámara dentro de escenas profundas), captura 4–6 tiempos de fotograma a lo largo del movimiento y superponlos (ffmpeg … -filter_complex blend=all_mode=lighten). Construye esta cebolla a mano para perspectiva anidada (snapshot --angle side la aplana) y para cámaras de proyección JS (3D proyectado en un SVG/lienzo): intercambia una cámara lateral en la función de proyección en la copia de prueba.

  5. Visualización a velocidad real. Si existe un render:

    • crea una tira: ffmpeg -i renders/video.mp4 -vf fps=6,scale=360:-1,tile=6x4 strip.jpg;
    • comprueba la duración y el primer y último fotograma con ffprobe;
    • si hay audio, comprueba cada golpe contra la hoja de pauta (±1 fotograma) y el pico verdadero ≤ −1 dBTP en el archivo AAC final (ffmpeg -i … -af ebur128=peak=true -f null -);
    • superposiciones .webm transparentes: ffprobe muestra VP9-alfa como yuv420p; verifica alfa decodificando con -c:v libvpx-vp9 antes de -i (la lectura de flujo muestra yuva420p) o la etiqueta ALPHA_MODE=1.
  6. Lectura de código. Busca en la composición:

    • ease: (lista cada ease utilizado) y duraciones;
    • entradas solo por opacidad y pequeños desplazamientos y: (20–40 px);
    • Math.random / Date.now (no determinista);
    • back.out|elastic|bounce, yoyo, repeat: -1;
    • lineal o power1 en movimientos espaciales; eases fuera de la lista permitida (mg.*, power3.out, expo.out, power3.in, power4.out, power2.inOut, none, un muelle horneado);
    • tweens concurrentes que comparten un ease (solo está bien si son un grupo bloqueado: un tween multiobjetivo o una línea de tiempo hija con defaults; un proxy controlado por setter cuenta una vez, por el ease de su tween);
    • una subida de máscara de línea borrosa que comience por debajo de yPercent 130 (el desenfoque se filtra en la máscara);
    • fuentes prohibidas;
    • falta de grano, viñeta o desenfoque de movimiento.
  7. Puntúa las 9 dimensiones (anclas abajo), 1–5, cada una con una razón de una línea vinculada a un tiempo o fotograma.

  8. Listón de artesanía (12 elementos, pasa/falla; tabla abajo).

  9. Escaneo anti-sopor (lista de 15 abajo). Registra los ids.

  10. Licencias. Cada activo no original (fuente, SFX, música, imagen, código de terceros) tiene una fuente y una licencia compatible por escrito. Fuentes: OFL o similar. Código: MIT o Apache con encabezados conservados. Algo desconocido: márcalo.

Anclas de rúbrica (puntuación 1–5)

Dimensión135
ConceptoSin idea; texto sobre fondos; cualquier marca podría intercambiarseIdea clara en una línea; el movimiento la respalda en algunas escenasUna idea fuerte de principio a fin con un momento sorprendente y propio que puedas describir en una oración
ComposiciónTodo centrado, tamaños uniformes, desorden o vacío sin intenciónCuadrícula, un héroe por fotograma, espacio negativo decenteCada imagen fija es de póster: recortes deliberados, capas de profundidad, espacio negativo; los diseños evolucionan
TipografíaFuente del sistema o genérica, tracking por defecto, bloques enteros que se desvanecenDivisión correcta (línea/palabra/carácter), revelaciones con máscara, legibleEl tipo es la animación: ejes variables, diseño cinético, juego de recorte/escala, ritmo impecable
Timing y easingEases lineales o por defecto, duraciones uniformes, sin pausasEases personalizados en movimientos héroe, duraciones variadas, pausas legiblesVelocidad asimétrica, sobrepaso elegante, pausas que se sienten inevitables fotograma a fotograma
CoreografíaTodo se mueve junto o con un escalonamiento uniformeEl héroe lidera, los soportes siguen con desplazamientos, superposición presenteDirigida: un gesto fluye hacia el siguiente, el movimiento secundario reacciona al primario
TransicionesCrossfades o cortes sin relaciónMáscaras/wipe diseñados, al ritmoUna cámara/idea continua; memorable, nunca gratuita
Profundidad y texturaVectores planos sobre un gradiente plano o de mancha, fotograma estáticoDeriva/empuje de cámara, 2+ planos de profundidad, algo de grano o luz3D real o 2.5D convincente, la iluminación cuenta la historia, la textura unifica sin presumir
Sincronía de sonidoSilencio o audio no relacionadoLos cortes principales caen en los beatsImagen y sonido compuestos juntos; el silencio usado como acento; mezcla limpia
AcabadoErrores, tirones, chasquidos, aliasing, activos no cargadosLimpio, coherente, fotograma final diseñadoEntregable de estudio; cada fotograma escrutado; fotograma final sostenido y resuelto

Las puntuaciones 2 y 4 se sitúan entre los anclajes. Para puntuar 4:

  • Timing: paleta de eases por rol, llegadas "rápido fuera, largo asentamiento", aceleración en salidas.
  • Coreografía: anticipación, seguimiento y escalonamientos suavizados o basados en distancia.
  • Transiciones: al menos un corte de coincidencia o morph, y cortes a velocidad máxima con desenfoque.
  • Profundidad: paralaje de 3 planos y desenfoque de movimiento en movimientos rápidos.
  • Composición: al menos 5× contraste de escala.

Una pieza silenciosa sin SFX que se declare silenciosa en el brief puntúa Sincronía de sonido basándose en sus silencios y ritmo visual; no castigues una elección deliberada.

Puertas duras (cualquiera = Bloque)

  • check falla, el render no es determinista, o una búsqueda muestra un fallo.
  • Texto que no se puede leer:
    • duración de pausa inferior a 0,5 s + 0,3 s por palabra;
    • contraste inferior a 4.5:1;
    • texto que cruza el área segura.
  • Destello de fuente, activo faltante, fotograma roto o vacío en una costura, o un salto en el primer o último fotograma.
  • 3 o más golpes anti-sopor sin una justificación por escrito.
  • Ease lineal o por defecto en un movimiento espacial héroe.
  • Un elemento del listón de artesanía faltante sin una exención por escrito en el brief.
  • Más de 3 destellos por segundo.
  • Un activo de terceros sin fuente o licencia registrada.

Listón de artesanía (12 elementos)

  1. Concepto. Una idea en una frase, y un momento característico alrededor del 40 % de la duración.
  2. Fotograma héroe. Un fotograma héroe diseñado (Composición ≥ 4, al menos 3 capas de profundidad).
  3. Cámara. Al menos un movimiento de cámara real o de profundidad, demostrado por la verificación fantasma o de ángulo lateral.
  4. Eases personalizados. Al menos 3 caracteres de ease distintos, y ningún tween concurrente compartiendo uno accidentalmente.
  5. Sin desvanecimiento por defecto. Sin opacity 0→1 + y 20–40→0 en ninguna parte.
  6. Costuras nombradas. Las costuras están nombradas y emparejadas por velocidad; como máximo un crossfade simple.
  7. Desenfoque de movimiento en 1–3 beats rápidos (nunca en texto mientras se lee).
  8. Pase de textura. Grano, viñeta y gradientes radiales (motivados por luz).
  9. Evento de luz. Al menos uno: un barrido, brillo, banda de escaneo, florecimiento o fuga.
  10. Sonido. Sincronía de sonido si hay audio; si no, la pieza se declara silenciosa.
  11. Ritmo.
    • El beat de storyboard más lento es al menos 3× el más rápido (los beats son filas de storyboard, no sub-tweens).
    • En todos los tweens, la duración máxima/mínima es al menos 4.
    • El fotograma fijo final dura al menos 0,8 s.
    • El último fotograma funciona como miniatura.
  12. Listón de rúbrica cumplido (ver Barra de envío).

Anti-sopor top 15

idSeñalSolución
S1Cada elemento aparece y se desliza hacia arriba 20–40 pxEntrada por rol: máscaras/divisiones para texto, escala desde punto para formas, cámara para escenas
S2Duraciones idénticas (todo 0,5 s / 1 s)Duración desde distancia y masa; llegadas héroe 0,8–1,5 s, salidas ~30 % más rápidas
S3Ease por defecto (power1, CSS ease, ease-in-out) o lineal en movimientos espacialesEases personalizados nombrados; asimétrico "rápido fuera, largo asentamiento"
S4Escalonamiento uniforme de 0,1 sEscalonamiento suavizado desde un origen significativo (centro, punto focal, orden de lectura)
S5Todo se mueve a la vez, misma velocidadUn líder; soportes siguen 2–8 fotogramas después con menos amplitud
S6Sin pausas: entra, sale directoPausa de lectura ≥ 0,5 s + 0,3 s/palabra
S7Paradas muertas: llega y se congelaAsentamiento largo, microderiva durante la pausa
S8Elastic/back/bounce en todoComo máximo un sobrepaso por pieza, ≤ 6 %, solo en transformaciones
S9Pulsos "respirantes" inactivos (escala/opacidad yoyo)Quietud, o un ambiente motivado, o una deriva de cámara con una pose final
S10Movimientos rápidos sin desenfoque de movimientoDesenfoque direccional o de obturador en los 1–3 beats más rápidos
S11Pila centrada: título / subtítulo / botónCuadrícula asimétrica, tipo anclado al borde, 30–50 % de espacio negativo
S12Fotograma estático, sin cámaraEmpuje, deriva, planos de paralaje, acercamientos en los beats
S13"Diapositivas": escena se desvanece, siguiente apareceCosturas motivadas: corte de coincidencia, impulso, máscara, morph
S14Manchas púrpura-azul / rosa-naranja, glassmorphism, neón en todoGradientes que se comportan como luz de una fuente; 2–3 tonos + neutros, acento ≤ 10 %
S15Inter/Roboto/Poppins regular como "el diseño"; emojis o iconos de stockTipo expresivo, tracking ajustado, contraste de peso; marcas personalizadas o ninguna

También vigila:

  • máquina de escribir + cursor como toda la idea;
  • números de conteo genéricos;
  • copia tipo lorem ("desbloquea el futuro de…");
  • un final que simplemente se detiene o se desvanece;
  • una curva de energía plana sin clímax;
  • movimiento que encajaría con cualquier mensaje.

Barra de envío

  • APROBAR: media ≥ 4.0, ninguna dimensión por debajo de 3, cero puertas duras.
  • PULIR: media 3.5–3.9, o una dimensión en 3. Lista de correcciones, luego re-revisión.
  • RETRABAJAR: media inferior a 3.5. Vuelve al concepto y los styleframes; pulir no lo salvará.

Formato de review.md

piece: <nombre> · reviewed: <fecha> · render: <ruta o ninguno>
concept: N — …            composition: N — …        typography: N — …
timing_easing: N — …      choreography: N — …       transitions: N — …
depth_texture: N — …      sound_sync: N — …         finish: N — …
average: N.N
hard_gates: [ … ]
craft_bar: [1 ✓, 2 ✗ (razón), …]
anti_slop_hits: [S1, S7, …]
verdict: APROBAR | PULIR | RETRABAJAR   → route fixes to: concept | composition | motion build
contact_sheet: <ruta>

Luego una tabla Antes | Después | Por qué. Ordénala por apalancamiento (impacto ÷ esfuerzo), y haz que cada "Después" sea un valor exacto:

#Dónde (t / fotograma / selector)AntesDespuésPor qué
13.40–3.90 s #titleopacidad + y 30, power2.out 0.5 sdividir en líneas, revelación con máscara, ease de asentamiento cubic-bezier(0,.65,.51,.99) 0.9 s, líneas +4 fotogramasdesvanecimiento por defecto (S1); sin asentamiento (S7)

Orden de corrección: eliminar → reducir → arreglar easing → arreglar composición/origen → reajustar tiempo → añadir profundidad/desenfoque/textura → pulir. Nunca escribas "hacerlo más dinámico"; da siempre una receta con números.

Re-revisión

Las re-revisiones vuelven al mismo revisor. Después de las correcciones, vuelve a ejecutar el paso 1, el paso 3 (regiones cambiadas y sus costuras) y el paso 7. Cualquier reajuste de tiempo vuelve a ejecutar check: sus muestras de contraste se mueven con el tiempo. Conserva las puntuaciones antiguas en review.md para que la mejora sea visible, y termina cada ronda con su propia línea verdict:. Detente después de 3 rondas de pulido; si la media sigue por debajo de 4.0, devuelve RETRABAJAR.


Parte de las habilidades gratuitas de mograf (MIT). Para el pipeline completo del estudio, consulta mograf.si. Cada pieza de la biblioteca incluye su prompt, habilidades, fuente y copia.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados