Communitygithub.com

motion-template

Crea o modifica una plantilla de Remotion mg reutilizable (gráficos animados impulsados por props y tokens). Úsala cuando ninguna plantilla existente se ajuste o cuando la animación de una plantilla deba cambiar.

¿Qué es motion-template?

Esta habilidad permite a agentes de IA (como Claude Code, Cursor o Codex) crear o modificar plantillas reutilizables para el sistema mg basado en Remotion. Una plantilla lee únicamente props de plano y tokens resueltos, y sigue un contrato estricto para garantizar reproducibilidad, consistencia y facilidad de mantenimiento. La habilidad guía al agente a través de la definición del esquema (props editables por el usuario), la implementación del componente con animaciones deterministas (usando `useCurrentFrame` e `interpolate`, sin efectos secundarios como CSS transitions, `setTimeout` o `Math.random`), y la validación mediante `check`. Además, soporta estilos predefinidos (looks) como corporate, sport y broadcast, proporcionando helpers como `choreo`, `reveal` y `typo` para mantener la coherencia visual. Es útil para desarrolladores que trabajan con el ecosistema mg y necesitan generar o adaptar templates animados de forma rápida y consistente, evitando errores comunes y siguiendo las mejores prácticas del framework.

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

Preguntar en tu IA favorita

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

Documentación

Plantillas

Una plantilla es un diseño reutilizable. Lee únicamente props de plano y tokens resueltos, y nada más. Lee motion-style antes de elegir tiempos o easing. Para detalles de la API de Remotion, usa las habilidades de Remotion si están instaladas (npx remotion skills add) o consulta https://www.remotion.dev/docs.

Dónde va

  • Específico del cliente: empieza con pnpm mg new-template <cliente> <nombre>. Crea un esqueleto funcional en clients/<cliente>/templates/<nombre>/index.tsx (id <cliente>/<nombre>) que sigue el contrato de abajo; reemplaza su diseño.
  • Casa (todos los clientes): templates/<nombre>/index.tsx en el repositorio motion-toolkit, registrado en templates/index.ts, lanzado con una nueva versión del toolkit. No escribas en node_modules.

Antes de escribir código de animación, propón el esquema (las props que el usuario podrá modificar sin un agente) y confírmalo con el usuario.

Contrato

import { interpolate, useCurrentFrame } from "remotion";
import { z } from "zod";
import { color, defineTemplate, font, motion, px, safeArea } from "motion-toolkit/engine";

const schema = z.object({
  headline: z.string().min(1).default("Headline"),
  holdSeconds: z.number().positive().default(3),
  accent: z.string().default("accent").describe("Nombre del token de color o #hex"),
});

export const template = defineTemplate({
  title: "Tarjeta de título",
  schema,
  durationSeconds: ({ props, tokens }) => {
    const m = motion(tokens, 1);
    return m.seconds("enter") + props.holdSeconds + m.seconds("exit");
  },
  check: ({ props, tokens }) => {
    color(tokens, props.accent); // lanza error si el token no existe; se ejecuta en `mg check`
  },
  component: ({ props, tokens, video }) => {
    const frame = useCurrentFrame();
    const m = motion(tokens, video.fps);
    // ...
  },
});

Requisitos:

  1. Exporta template (plantillas del cliente) creado con defineTemplate.
  2. Cada campo del esquema tiene un .default() para que nuevos planos y el Studio comiencen con valores válidos. Añade .describe() para el formulario del Studio.
  3. Colores mediante color(tokens, nombreOHex), fuentes mediante font(tokens, rol), duraciones y easing mediante motion(tokens, fps), posiciones dentro de safeArea(tokens, video), tamaños mediante px(tamañoEn1080, video).
  4. Anima solo con useCurrentFrame() y interpolate/spring. Sin transiciones CSS, setTimeout, Date.now() o Math.random() (usa random(semilla) de remotion). Los renders deben ser idénticos cada vez.
  5. Deja el fondo transparente a menos que la plantilla sea a pantalla completa; los terceros inferiores y superposiciones renderizan con alfa. Todos los elementos deben desaparecer en el último fotograma.
  6. Falla de forma ruidosa: lanza un Error con una pista de solución cuando el texto no quepa o falte un token. Usa assertFits/wrapLines del motor; miden con la fuente cargada y lanzan error en desbordamiento.
  7. Las props que nombran tokens (colores, logos, fuentes, sonidos) se validan en check con checkRefs, para que mg check detecte errores tipográficos antes de renderizar.
  8. durationSeconds y check se ejecutan en Node (mg check) y antes de cargar fuentes: nunca midas texto allí.
  9. Imágenes y logos: <Img src={staticFile(tokens.logos[nombre])} /> o staticFile(props.algunAsset). Sonidos: <Html5Audio src={staticFile(archivo)} /> dentro de un <Sequence from={fotograma}>, archivos de tokens.sounds[nombre]. El CLI gestiona los archivos.

Looks

Las plantillas de casa, y las plantillas de cliente diseñadas para coincidir con ellas, reciben look: lookSchema y lo resuelven con resolveLook(props.look, tokens). Constrúyelas a partir de los helpers compartidos para que los tres looks se mantengan consistentes (consulta motion-style):

  • choreo(tokens, look, fps) proporciona beat(frame, index, exitStart, steps) → { inP, outP } para cada elemento en orden de entrada; choreoSeconds(...) da la duración correspondiente.
  • reveal(look, beat, video) es el estilo de entrada del look para un elemento (enciérralo en overflow: hidden para corporate).
  • typo(tokens, look, "display" | "title" | "body" | "label", size) es el estilo tipográfico del look; onColor(hex) elige texto legible sobre un bloque de color; cornerPlacement(corner, inset) posiciona gráficos en las esquinas.

Lee una plantilla de casa como node_modules/motion-toolkit/templates/title-card/index.tsx como ejemplo práctico.

Verificar

  1. pnpm mg new-shot <cliente>/<proyecto> <plano> --template <cliente>/<nombre> en un proyecto de prueba, más un segundo plano con el texto realista más largo.
  2. pnpm mg check <cliente>/<proyecto>.
  3. pnpm mg still <cliente>/<proyecto> <plano> y mira los fotogramas. Luego pnpm mg render.
  4. Sigue motion-qa.

Trabajar desde un clip de referencia

Cuando el usuario proporcione un video de referencia, extrae fotogramas antes de diseñar. Crea renders/reference/ primero; el ffmpeg incluido es una compilación mínima sin filtros, así que usa -r para la tasa de fotogramas:

pnpm mg ffmpeg -i referencia.mp4 -r 10 renders/reference/f_%03d.png

Describe a partir de los fotogramas qué se mueve, en qué orden, cuánto dura cada fase (cuenta fotogramas a 10 fps) y la sensación del easing. Confirma ese desglose con el usuario, luego mapealo a tokens: duraciones a motion.durations, curvas a motion.easings.

Individual skills in this repo

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

Skills relacionados