Communitygithub.com

motion-render

Renderiza, entrega y re-marca tomas de motion graphics: ajustes preestablecidos, versiones de salida, entrega (verificar + congelar + copiar finales) y re-marca para aplicar cambios de marca a proyectos entregados.

¿Qué es motion-render?

Esta habilidad automatiza el flujo de trabajo de postproducción de motion graphics para equipos que utilizan una configuración basada en cliente/proyecto con un paquete de herramientas interno (mg). Permite renderizar tomas individuales o todas las tomas de un proyecto con seguimiento de versiones, utilizando ajustes preestablecidos como overlay (ProRes 4444 con alpha para títulos) o delivery (H.264 para revisión). El comando `deliver` verifica que cada render cumpla con los requisitos técnicos (códec, tamaño de fotograma, FPS), congela el proyecto para evitar cambios no deseados de versiones futuras y copia los archivos finales a una carpeta con fecha. La funcionalidad de re-marca vuelve a aplicar tokens de cliente o variante (colores, fuentes, logotipos) a proyectos existentes: primero previsualiza los cambios, luego aplica la re-marca con un solo comando, volviendo a renderizar las tomas afectadas y actualizando la carpeta de entrega si es necesario. Incluye herramientas de diagnóstico (`mg check` y `mg doctor`) para validar la configuración del proyecto antes de renderizar.

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

Preguntar en tu IA favorita

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

Documentación

Renderizado y entrega

Ejecuta pnpm mg check <cliente>/<proyecto> primero; renderiza solo cuando no informe problemas.

Renderizar

pnpm mg render <cliente>/<proyecto>            todas las tomas
pnpm mg render <cliente>/<proyecto> lt-ceo     una toma
pnpm mg render <cliente>/<proyecto> --force    volver a renderizar incluso si no hay cambios

Salida: renders/<toma>_v<NNN>.<ext>. Cada render que cambia píxeles obtiene la siguiente versión; las versiones anteriores se conservan. renders/manifest.json registra el hash de todo lo que afecta a los píxeles (props, tokens resueltos, contenido de fuentes/logotipos/recursos, ajuste preestablecido, versión del toolkit, código de plantilla del cliente). Las tomas sin cambios se omiten.

Ajustes preestablecidos

Ajuste preestablecidoArchivoUso
overlay (predeterminado)ProRes 4444 .mov con alphaTerceros inferiores, títulos sobre material de archivo en Resolve/Premiere/FCP
deliveryH.264 .mp4, áreas transparentes en negroEnlaces de revisión, gráficos a pantalla completa
webm-alphaVP9 .webm con alphaReproductores web; la mayoría de los editores ignoran el alpha de WebM

Se establece por toma ("preset"), por proyecto (project.json) o por ejecución (--preset).

Entregar

Cuando el usuario entrega un proyecto (o dice que los gráficos están finales):

pnpm mg deliver <cliente>/<proyecto> [toma…]

Renderiza lo que cambió, verifica cada archivo (alpha para overlay/webm-alpha, tamaño de fotograma, fps), congela el proyecto y copia los finales a deliver/<AAAA-MM-DD>/<toma>.<ext>. Si la verificación falla, no se congela ni copia nada; corrige el problema informado y vuelve a ejecutarlo. Indica al usuario la ruta de la carpeta deliver/.

Congelado significa que las ediciones posteriores de la casa, del cliente o de variantes no cambian los renders de este proyecto.

Aplicar cambios de marca

Después de que el usuario cambie los tokens del cliente o de la variante (nuevos colores, fuentes, logotipos):

  1. Vista previa: pnpm mg rebrand <cliente> (o <cliente>/<proyecto> para un proyecto). No cambia nada y lista, por proyecto, lo que la marca actual cambiaría. Los proyectos con "extends": "none" se omiten.
  2. Muestra la lista al usuario y pregúntale cuáles actualizar: todos, algunos proyectos o ninguno (solo trabajo nuevo).
  3. Aplica lo que eligió: pnpm mg rebrand <cliente> --apply o pnpm mg rebrand <cliente>/<proyecto> --apply por proyecto. Los proyectos congelados se vuelven a bloquear a la marca actual; cada proyecto listado se vuelve a renderizar en una nueva versión. Las versiones antiguas permanecen en renders/.
  4. Ejecuta motion-qa en los nuevos renders. Para los proyectos que el usuario vuelve a entregar, ejecuta pnpm mg deliver para actualizar deliver/.

No ejecutar rebrand también es una respuesta válida: los proyectos congelados mantienen su apariencia entregada, y solo los proyectos no congelados siguen la marca en su próximo render.

Otros comandos de marca:

  • pnpm mg diff <cliente>/<proyecto>: las diferencias de un proyecto con respecto a su bloqueo (congelado) o su último render (no congelado).
  • Un render de un proyecto no congelado cuya marca ha cambiado desde su último render imprime una advertencia con los cambios.
  • Ediciones de tokens solo del proyecto en un proyecto congelado: edita tokens.json, luego pnpm mg rebrand <cliente>/<proyecto> --apply.

Fallos

  • Los errores que mencionan una prop, token, fuente o ancho de texto provienen de la validación; corrige el JSON, no la plantilla. pnpm mg check los enumera todos a la vez.
  • Errores de lanzamiento del navegador, bibliotecas faltantes, códec o ruta: pnpm mg doctor.

Individual skills in this repo

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

Skills relacionados