Communitygithub.com

motion-render

Renderizar, entregar e reaplicar marcas em cenas de motion graphics usando presets, versões de saída, verificação e congelamento de entregáveis.

O que é motion-render?

Este skill gerencia o pipeline de renderização e entrega de projetos de motion graphics para ferramentas de IA como Claude Code, Cursor e Codex. Ele permite renderizar cenas individuais ou completas com suporte a diferentes presets de saída (como Overlay com alpha, Delivery em H.264 e WebM com alpha), verificar a integridade dos renders, congelar versões finais e reaplicar alterações de marca (como novas cores, fontes ou logotipos) sem perder versões anteriores. O comando `pnpm mg check` é usado para validar projetos antes de renderizar, enquanto `pnpm mg deliver` realiza a entrega final com verificação e congelamento. Para reaplicar marca, utiliza-se `pnpm mg rebrand`, que lista as mudanças primeiro antes de aplicar. O skill é útil para desenvolvedores e motion designers que precisam de um fluxo confiável e repetível de renderização e entrega, evitando retrabalho e garantindo consistência visual.

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

Perguntar na sua IA favorita

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

Documentação

Renderização e entrega

Execute pnpm mg check <cliente>/<projeto> primeiro; renderize apenas quando não houver problemas relatados.

Renderizar

pnpm mg render <cliente>/<projeto>            todas as cenas
pnpm mg render <cliente>/<projeto> lt-ceo     uma cena
pnpm mg render <cliente>/<projeto> --force    re-renderizar mesmo se inalterado

Saída: renders/<cena>_v<NNN>.<ext>. Cada renderização que alterar pixels recebe a próxima versão; versões anteriores permanecem. renders/manifest.json registra o hash de tudo que afeta pixels (props, tokens resolvidos, conteúdo de fontes/logotipos/ativos, preset, versão do toolkit, código do modelo do cliente). Cenas inalteradas são puladas.

Presets

PresetArquivoUso
overlay (padrão)ProRes 4444 .mov com alphaTerços inferiores, títulos sobre footage no Resolve/Premiere/FCP
deliveryH.264 .mp4, áreas transparentes em pretoLinks de revisão, gráficos em tela cheia
webm-alphaVP9 .webm com alphaPlayers web; a maioria dos editores ignora alpha WebM

Defina por cena ("preset"), por projeto (project.json) ou por execução (--preset).

Entregar

Quando o usuário entregar o projeto (ou disser que os gráficos estão finais):

pnpm mg deliver <cliente>/<projeto> [cena…]

Isso renderiza o que mudou, verifica cada arquivo (alpha para overlay/webm-alpha, tamanho do quadro, fps), congela o projeto e copia os finais para deliver/<AAAA-MM-DD>/<cena>.<ext>. Se a verificação falhar, nada é congelado ou copiado; corrija o problema relatado e execute novamente. Informe ao usuário o caminho da pasta deliver/.

Congelado significa: edições futuras de casa, cliente ou variante não alteram os renders deste projeto.

Aplicar alterações de marca

Após o usuário alterar tokens de cliente ou variante (novas cores, fontes, logotipos):

  1. Visualizar: pnpm mg rebrand <cliente> (ou <cliente>/<projeto> para um projeto). Não altera nada e lista, por projeto, o que a marca atual mudaria. Projetos com "extends": "none" são pulados.
  2. Mostre a lista ao usuário e pergunte quais atualizar: todos, alguns projetos ou nenhum (apenas trabalho novo).
  3. Aplique o que escolheram: pnpm mg rebrand <cliente> --apply ou pnpm mg rebrand <cliente>/<projeto> --apply por projeto. Projetos congelados são relocados para a marca atual; cada projeto listado é re-renderizado em uma nova versão. Versões antigas permanecem em renders/.
  4. Execute motion-qa nos novos renders. Para projetos que o usuário entregar novamente, execute pnpm mg deliver para atualizar deliver/.

Não executar rebrand também é uma resposta válida: projetos congelados mantêm sua aparência entregue, e apenas projetos não congelados seguem a marca em sua próxima renderização.

Outros comandos de marca:

  • pnpm mg diff <cliente>/<projeto>: diferenças de um projeto em relação ao seu bloqueio (congelado) ou última renderização (não congelado).
  • Uma renderização de um projeto não congelado cuja marca mudou desde sua última renderização exibe um aviso com as alterações.
  • Edições de tokens apenas no projeto em um projeto congelado: edite tokens.json, depois pnpm mg rebrand <cliente>/<projeto> --apply.

Falhas

  • Erros que nomeiam uma prop, token, fonte ou largura de texto vêm da validação; corrija o JSON, não o modelo. pnpm mg check lista todos de uma vez.
  • Inicialização do navegador, bibliotecas ausentes, codec ou erros de caminho: pnpm mg doctor.

Individual skills in this repo

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

Habilidades Relacionadas