Communitygithub.com

motion

Punto de entrada para cualquier trabajo de gráficos animados en un espacio de trabajo mg (mg.json en la raíz): rótulos inferiores, títulos, texto animado, cambios de marca, renders. Léelo primero; dirige a las otras skills motion-*.

¿Qué es motion?

Esta skill es el punto de entrada central para cualquier trabajo de gráficos animados en un espacio de trabajo `mg`. Define la estructura completa del workspace, basada en un archivo `mg.json` en la raíz y una jerarquía de tokens (casa, cliente, variante, proyecto) que permite personalizar colores, fuentes y estilos sin tocar el código de las plantillas. Soporta plataformas como Remotion y se integra con el CLI `pnpm mg` para gestionar proyectos, plantillas y renders. La skill explica la cadena de tokens, las reglas de diseño (sin valores fijos en código) y las plantillas de casa predefinidas (como `lower-third`, `title-card`, `callout`). Además, proporciona una ruta clara: desde `motion-brand` para cambios de marca, `motion-project` para proyectos, `motion-template` para nuevas plantillas, `motion-style` para ajustes de animación, `motion-render` para renderizado y `motion-qa` para control de calidad. Es útil para desarrolladores y diseñadores que necesitan un flujo de trabajo eficiente, repetible y sin errores para gráficos animados en producción.

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

Preguntar en tu IA favorita

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

Documentación

Espacio de trabajo Motion

Este espacio de trabajo renderiza gráficos animados repetibles con Remotion a través del CLI mg (pnpm mg <comando>). Los diseños son código en plantillas; cada valor específico de un trabajo vive en JSON. Un cambio de texto, color o fuente es una edición JSON más pnpm mg render, nunca un cambio de código.

Estructura

mg.json                         valores por defecto del video del espacio de trabajo (fps, tamaño)
brand/house.tokens.json         tokens de casa: colores base, fuentes, easing, duraciones, áreas seguras
brand/fonts/  brand/logos/      archivos a los que hacen referencia los tokens de casa
clients/<cliente>/
  client.json                   nombre visible, opcional anulación de video
  brand/tokens.json             anulaciones del cliente (fusión profunda sobre la casa)
  brand/fonts/ brand/logos/
  brand/variants/<variante>/    look alternativo con nombre reutilizado por varios proyectos: tokens.json, fonts/, logos/
  templates/<nombre>/index.tsx  plantillas solo del cliente, id "<cliente>/<nombre>"
  projects/<proyecto>/
    project.json                { title?, extends?: "client"|"none", brand?: "<variante>", video?, preset? }
    tokens.json                 anulaciones solo del proyecto (opcional)
    tokens.lock.json            presente cuando está congelado: los renders ignoran la cadena activa
    fonts/ logos/ assets/       archivos del proyecto; las props referencian assets como "asset:<ruta>"
    shots/<toma>.props.json     { template, props, durationSeconds?, preset?, video? }
    renders/                    salida, ignorado por git; manifest.json rastrea versiones

El código del toolkit (motor, plantillas de casa, estas skills) vive en node_modules/motion-toolkit, fijado por package.json. Nunca lo edites ahí; los cambios en plantillas de casa van al repositorio del toolkit.

Plantillas de casa

Cada plantilla de casa tiene una prop look: minimal (limpio, pesos ligeros, difuminado ascendente, sin paneles), bold (tipografía pesada en mayúsculas, bloques de color sólido, pop con resorte), corporate (paneles, barras de acento, revelaciones con máscara). El valor por defecto "brand" usa el token look, así que un cliente establece su estilo una vez en brand/tokens.json ("look": "minimal").

IdUso
lower-thirdNombre y título, logo opcional
title-cardTítulo de capítulo o sección, opcional anticipo y subtítulo; superposición o pantalla completa
calloutLínea desde un punto en el metraje (x, y como fracciones del fotograma) hasta una etiqueta
end-cardTarjeta de cierre: logo, titular, CTA, URL, 0–2 ranuras de pantalla final de YouTube
kinetic-textCita o declaración revelada palabra por palabra; *palabra* enfatiza
logo-stingAnimación corta de logo (intro/outro)
counterNúmero contando hacia arriba (value, prefix, suffix, decimals) con una etiqueta
social-handleIcono de plataforma más @handle en una esquina (YouTube, Instagram, TikTok, X, LinkedIn, …)
typewriterTexto escrito tecla por tecla con sonidos de máquina de escribir o teclado en el audio del render
corner-brandingUna marca persistente en cualquier esquina, etiqueta opcional como EN VIVO

pnpm mg new-shot … --template <id> escribe cada prop con su valor por defecto. El significado de cada prop está en su texto .describe() en node_modules/motion-toolkit/templates/<id>/index.tsx.

Cadena de tokens

toolkit → casa → cliente → variante (si project.json tiene "brand") → project tokens.json → props de toma. La capa del toolkit solo proporciona valores por defecto (el look, una fuente mono, sounds de escritura). Los objetos se fusionan clave por clave, null elimina una clave heredada, y la capa más específica gana. "extends": "none" omite cliente y variante. Los archivos de fuente, logo y sonido se buscan en la carpeta fonts/, logos/ o sounds/ de la capa más específica que los tenga.

Reglas

  1. Cada valor visible proviene de props de toma o tokens. Sin colores, fuentes, tamaños en px sin una prop, o tiempos fijos en las plantillas.
  2. Los proyectos contienen datos, no código. Un nuevo diseño es una plantilla; un nuevo trabajo es un proyecto con archivos de toma.
  3. Coloca un valor en la capa más baja que lo posea: una toma → props de toma; un proyecto → tokens.json del proyecto; varios proyectos de un cliente → una variante; todo el cliente → tokens del cliente.
  4. Nunca edites tokens.lock.json a mano. Los proyectos entregados están congelados; solo cambian mediante mg rebrand (ver motion-render).
  5. Después de cada edición de JSON o plantilla, ejecuta pnpm mg check y corrige lo que informe antes de renderizar.
  6. Termina cada cambio visual con el procedimiento motion-qa antes de reportarlo como completado.
  7. Pregunta al usuario antes de mg rebrand --apply y antes de editar tokens de cliente o variante usados por proyectos congelados.
  8. Si falla un render o una verificación doctor, ejecuta pnpm mg doctor antes de cambiar código.

Ruta

TareaLeer
Nuevo cliente, variante, logo, fuente, paleta de coloresmotion-brand
Nuevo proyecto o tomas desde un briefing; cambiar texto/colores en tomas existentesmotion-project
Nueva plantilla o cambio en cómo anima una plantillamotion-template, luego motion-style
Sensación de movimiento: easing, timing, stagger, áreas segurasmotion-style
Renderizado, presets, versiones, entrega, aplicación de cambios de marcamotion-render
Verificación de la salida antes de entregarlamotion-qa

Comandos

pnpm mg templates                                  listar ids de plantillas
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <cliente>/<proyecto> <toma> --template <id>   archivo de toma con todas las props en valores por defecto
pnpm mg new-template <cliente> <nombre>               plantilla inicial
pnpm mg check [<cliente> | <cliente>/<proyecto>]      validar todo sin renderizar
pnpm mg render <cliente>/<proyecto> [toma…]          omite tomas sin cambios; --force, --preset
pnpm mg still <cliente>/<proyecto> [toma…]           revisar PNGs sobre un tablero de ajedrez (todas las tomas por defecto)
pnpm mg studio <cliente>/<proyecto>                  vista previa en vivo; el botón "Guardar" del Studio escribe el archivo de toma
pnpm mg deliver <cliente>/<proyecto>                 renderizar, verificar, congelar, copiar finales a deliver/<fecha>/
pnpm mg rebrand <cliente | cliente/proyecto> [--apply]   cambios de marca para trabajos entregados
pnpm mg freeze|unfreeze|diff <cliente>/<proyecto>
pnpm mg doctor                                     entorno, mg check, render de prueba

Individual skills in this repo

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

Skills relacionados