Communitygithub.com

motion

Ponto de entrada para qualquer trabalho de motion graphics em um workspace mg (mg.json na raiz) — lower thirds, títulos, texto animado, alterações de marca, renders. Leia primeiro; ele roteia para as outras skills motion-*.

O que é motion?

Motion workspace é o ponto de entrada para todos os projetos de motion graphics em um workspace mg, usando Remotion e a CLI `mg` (`pnpm mg <comando>`). Todo design é código em templates, enquanto valores específicos de cada job ficam em JSON — uma mudança de texto, cor ou fonte é apenas uma edição em JSON seguida de `pnpm mg render`, sem tocar em código. A estrutura de diretórios organiza marcas (house/cliente), templates, variantes, projetos e shots (tomadas), com uma cadeia de tokens que mescla camadas hierarquicamente: toolkit → house → cliente → variante → projeto → props do shot. A skill roteia tarefas para skills especializadas como `motion-project`, `motion-brand`, `motion-template`, `motion-style`, `motion-render` e `motion-qa`, garantindo que cada alteração visual siga regras como "nunca editar tokens.lock.json manualmente" e "rodar pnpm mg check antes de renderizar". É ideal para fluxos de produção repetíveis, suporta ambientes multi-cliente e mantém consistência de marca com templates de casa (ex.: minimal, bold, corporate).

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

Perguntar na sua IA favorita

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

Documentação

Workspace Motion

Este workspace renderiza motion graphics repetíveis com Remotion através da CLI mg (pnpm mg <comando>). Os designs são código em templates; cada valor específico de job vive em JSON. Uma alteração de texto, cor ou fonte é uma edição em JSON mais pnpm mg render, nunca uma alteração de código.

Layout

mg.json                         padrões de vídeo do workspace (fps, tamanho)
brand/house.tokens.json         tokens da casa: cores base, fontes, easing, durações, áreas seguras
brand/fonts/  brand/logos/      arquivos referenciados pelos tokens da casa
clients/<cliente>/
  client.json                   nome de exibição, sobrescrita de vídeo opcional
  brand/tokens.json             sobrescritas do cliente (deep-merge sobre a casa)
  brand/fonts/ brand/logos/
  brand/variants/<variante>/    look alternativo nomeado reutilizado por vários projetos: tokens.json, fonts/, logos/
  templates/<nome>/index.tsx    templates exclusivos do cliente, id "<cliente>/<nome>"
  projects/<projeto>/
    project.json                { title?, extends?: "client"|"none", brand?: "<variante>", video?, preset? }
    tokens.json                 sobrescritas apenas do projeto (opcional)
    tokens.lock.json            presente quando congelado: renders ignoram a cadeia ativa
    fonts/ logos/ assets/       arquivos do projeto; props referenciam assets como "asset:<caminho>"
    shots/<shot>.props.json     { template, props, durationSeconds?, preset?, video? }
    renders/                    saída, ignorada pelo git; manifest.json rastreia versões

O código do toolkit (engine, templates da casa, estas skills) vive em node_modules/motion-toolkit, fixado por package.json. Nunca edite lá; alterações em templates da casa vão para o repositório do toolkit.

Templates da Casa

Cada template da casa tem uma prop look: minimal (limpo, pesos leves, blur-rise, sem painéis), bold (tipografia pesada em maiúsculas, blocos de cor sólida, spring pop), corporate (painéis, barras de destaque, revelações com máscara). O padrão "brand" usa o token look, então um cliente define seu estilo uma vez em brand/tokens.json ("look": "minimal").

IdUso
lower-thirdFaixa de nome e título, logotipo opcional
title-cardTítulo de capítulo ou seção, opcional kicker e subtítulo; sobreposição ou tela cheia
calloutLinha de um ponto na filmagem (x, y como frações do quadro) até um rótulo
end-cardCartão de encerramento: logotipo, manchete, CTA, URL, 0–2 slots de tela final do YouTube
kinetic-textCitação ou afirmação revelada palavra por palavra; *palavra* enfatiza
logo-stingBreve animação de logotipo (abertura/encerramento)
counterNúmero contando para cima (value, prefix, suffix, decimals) com um rótulo
social-handleÍcone da plataforma mais @handle em um canto (YouTube, Instagram, TikTok, X, LinkedIn, …)
typewriterTexto digitado tecla por tecla com sons de máquina de escrever ou teclado no áudio do render
corner-brandingMarca d'água persistente do logotipo em qualquer canto, tag opcional como AO VIVO

pnpm mg new-shot … --template <id> escreve cada prop com seu padrão. O significado de cada prop está em seu texto .describe() em node_modules/motion-toolkit/templates/<id>/index.tsx.

Cadeia de Tokens

toolkit → casa → cliente → variante (se project.json "brand") → project tokens.json → shot props. A camada do toolkit fornece apenas padrões (o look, uma fonte mono, sounds de digitação). Objetos mesclam chave por chave, null deleta uma chave herdada, e a camada mais específica vence. "extends": "none" pula cliente e variante. Arquivos de fonte, logotipo e som são encontrados na pasta fonts/, logos/ ou sounds/ da camada mais específica que os possui.

Regras

  1. Todo valor visível vem de props de shot ou tokens. Sem cores, fontes, tamanhos em px sem uma prop, ou temporizações hard-coded em templates.
  2. Projetos contêm dados, não código. Um novo design é um template; um novo job é um projeto com arquivos de shot.
  3. Coloque um valor na camada mais baixa que o possui: um shot → props do shot; um projeto → tokens.json do projeto; vários projetos de um cliente → uma variante; o cliente inteiro → tokens do cliente.
  4. Nunca edite tokens.lock.json manualmente. Projetos entregues são congelados; eles mudam apenas através de mg rebrand (veja motion-render).
  5. Após cada edição de JSON ou template, execute pnpm mg check e corrija o que ele relatar antes de renderizar.
  6. Finalize cada alteração visual com o procedimento motion-qa antes de reportá-la como concluída.
  7. Pergunte ao usuário antes de mg rebrand --apply e antes de editar tokens de cliente ou variante usados por projetos congelados.
  8. Se um render ou verificação de doctor falhar, execute pnpm mg doctor antes de alterar código.

Roteamento

TarefaLeia
Novo cliente, variante, logotipo, fonte, paleta de coresmotion-brand
Novo projeto ou shots a partir de um briefing; alterar texto/cores em shots existentesmotion-project
Novo template ou uma alteração em como um template animamotion-template, depois motion-style
Sensação de movimento: easing, timing, stagger, áreas segurasmotion-style
Renderização, presets, versões, entrega, aplicação de alterações de marcamotion-render
Verificação da saída antes de entregarmotion-qa

Comandos

pnpm mg templates                                  lista ids de templates
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <cliente>/<projeto> <shot> --template <id>   arquivo de shot com todas as props nos padrões
pnpm mg new-template <cliente> <nome>               template inicial
pnpm mg check [<cliente> | <cliente>/<projeto>]      valida tudo sem renderizar
pnpm mg render <cliente>/<projeto> [shot…]          pula shots não alterados; --force, --preset
pnpm mg still <cliente>/<projeto> [shot…]           revisa PNGs em um tabuleiro de damas (todos os shots por padrão)
pnpm mg studio <cliente>/<projeto>                  pré-visualização ao vivo; "Save" do Studio escreve o arquivo de shot
pnpm mg deliver <cliente>/<projeto>                 renderiza, verifica, congela, copia finais para deliver/<data>/
pnpm mg rebrand <cliente | cliente/projeto> [--apply]   alterações de marca para trabalho entregue
pnpm mg freeze|unfreeze|diff <cliente>/<projeto>
pnpm mg doctor                                     ambiente, mg check, render de teste

Individual skills in this repo

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

Habilidades Relacionadas