Communitygithub.com

motion-template

Crie ou modifique um modelo Remotion do mg (um gráfico animado reutilizável baseado em props e tokens). Use quando nenhum modelo existente atender ou quando a animação de um modelo precisar ser alterada.

O que é motion-template?

Esta skill capacita agentes de IA (como Claude Code, Cursor ou Codex) a criar ou modificar modelos Remotion dentro do ecossistema motion-toolkit. Um modelo é um design reutilizável que lê props de cena e tokens resolvidos, gerando gráficos animados consistentes. Ela define um contrato rígido baseado em TypeScript, usando `defineTemplate` com validação de esquema Zod, duração calculada via `motion(tokens, fps)`, animação exclusivamente com `useCurrentFrame()`, `interpolate`/`spring` do Remotion, e renderização determinística (sem `Math.random()`). A skill especifica onde os modelos devem ser armazenados (clientes ou repositório house), exige que cores, fontes e durações sejam obtidas através dos helpers do toolkit para garantir consistência visual, e recomenda validação via `mg check`, `mg still` e `mg render`. Também orienta o uso de looks (aparências) compartilhados e como extrair frames de um vídeo de referência para mapear movimentos a tokens de animação.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Modelos (Templates)

Um modelo é um design reutilizável. Ele lê props de cena e tokens resolvidos, e nada mais. Leia motion-style antes de escolher temporizações ou easing. Para detalhes da API Remotion, use as skills do Remotion se instaladas (npx remotion skills add) ou https://www.remotion.dev/docs.

Onde colocar

  • Específico do cliente: comece com pnpm mg new-template <cliente> <nome>. Ele cria um starter funcional em clients/<cliente>/templates/<nome>/index.tsx (id <cliente>/<nome>) que segue o contrato abaixo; substitua seu design.
  • Casa (todos os clientes): templates/<nome>/index.tsx no repositório motion-toolkit, registrado em templates/index.ts, liberado com uma nova versão do toolkit. Não escreva em node_modules.

Antes de escrever código de animação, proponha o esquema (as props que o usuário poderá alterar sem um agente) e confirme com o usuário.

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("Nome do token de cor ou #hex"),
});

export const template = defineTemplate({
  title: "Cartão 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); // lança erro em nomes de token desconhecidos; é executado em `mg check`
  },
  component: ({ props, tokens, video }) => {
    const frame = useCurrentFrame();
    const m = motion(tokens, video.fps);
    // ...
  },
});

Requisitos:

  1. Exporte template (modelos de cliente) construído com defineTemplate.
  2. Todo campo do esquema deve ter um .default() para que novas cenas e o Studio iniciem válidos. Adicione .describe() para o formulário do Studio.
  3. Cores através de color(tokens, nomeOuHex), fontes através de font(tokens, papel), durações e easing através de motion(tokens, fps), posições dentro de safeArea(tokens, video), tamanhos através de px(tamanhoEm1080, video).
  4. Anime apenas a partir de useCurrentFrame() com interpolate/spring. Sem transições CSS, setTimeout, Date.now() ou Math.random() (use random(semente) do remotion). As renderizações devem ser idênticas a cada execução.
  5. Deixe o fundo transparente a menos que o modelo seja em tela cheia; barras inferiores e sobreposições renderizam com alpha. Todo elemento deve desaparecer no último quadro.
  6. Falhe ruidosamente: lance um Error com uma dica de correção quando o texto não couber ou algum token estiver ausente. Use assertFits/wrapLines do motor; eles medem com a fonte carregada e lançam erro em estouro.
  7. Props que nomeiam tokens (cores, logotipos, fontes, sons) são validadas em check com checkRefs, para que mg check pegue erros de digitação antes de renderizar.
  8. durationSeconds e check são executados no Node (mg check) e antes das fontes carregarem: nunca meça texto lá.
  9. Imagens e logotipos: <Img src={staticFile(tokens.logos[nome])} /> ou staticFile(props.algumAsset). Sons: <Html5Audio src={staticFile(arquivo)} /> dentro de <Sequence from={frame}>, arquivos de tokens.sounds[nome]. O CLI prepara os arquivos.

Aparências (Looks)

Modelos da casa, e modelos de cliente que devem combiná-los, recebem look: lookSchema e o resolvem com resolveLook(props.look, tokens). Construa-os a partir dos helpers compartilhados para que todas as três aparências permaneçam consistentes (veja motion-style):

  • choreo(tokens, look, fps) fornece beat(frame, index, exitStart, steps) → { inP, outP } para cada elemento na ordem de entrada; choreoSeconds(...) fornece a duração correspondente.
  • reveal(look, beat, video) é o estilo de entrada da aparência para um elemento (envolva em overflow: hidden para corporate).
  • typo(tokens, look, "display" | "title" | "body" | "label", tamanho) é o estilo tipográfico da aparência; onColor(hex) escolhe texto legível sobre um bloco de cor; cornerPlacement(canto, margem) posiciona gráficos de canto.

Leia um modelo da casa como node_modules/motion-toolkit/templates/title-card/index.tsx como exemplo prático.

Verificar

  1. pnpm mg new-shot <cliente>/<projeto> <cena> --template <cliente>/<nome> em um projeto de teste, mais uma segunda cena com o texto realista mais longo.
  2. pnpm mg check <cliente>/<projeto>.
  3. pnpm mg still <cliente>/<projeto> <cena> e olhe os quadros. Depois pnpm mg render.
  4. Siga motion-qa.

Trabalhando a partir de um clipe de referência

Quando o usuário fornecer um vídeo de referência, extraia quadros antes de projetar. Crie renders/reference/ primeiro; o ffmpeg incluído é uma build mínima sem filtros, então use -r para a taxa de quadros:

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

Descreva a partir dos quadros o que se move, em qual ordem, quanto tempo cada fase leva (conte quadros a 10 fps) e a sensação do easing. Confirme essa análise com o usuário, então mapeie para tokens: durações para motion.durations, curvas para motion.easings.

Individual skills in this repo

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

Habilidades Relacionadas