Instalação do Plugin: Antes dos comandos de configuração ou atualização, siga as regras de execução do plugin quando este skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
Primeiro, mantenha este skill atualizado — confirme com o usuário antes de executar:
npx hyperframes skills update motion-graphics. Uma operação rápida quando tudo está atualizado; caso contrário, ele atualiza este skill e os skills de domínio principais dos quais depende antes de você usá-los.
fonte figma: Se o logotipo/ativo/animação a ser construído(a) vier de uma URL figma.com, execute
/figmaprimeiro — exportação de ativos, tokens de marca e tradução Motion→GSAP se o gráfico for uma importação do Figma Motion — depois construa a partir de sua saída. Não acione o Figma via ferramentas MCP brutas diretamente: isso ignora a sanitização SVG, a proveniência.media/manifest.jsonle a vinculaçãovar()do token de marca, de modo que uma alteração posterior da marca não pode ser propagada sem uma reimportação completa.
motion-graphics — ponto de entrada de despacho
A porta de entrada é
/hyperframes. Este skill cria um motion graphic curto, orientado pelo design e sem narração (o movimento é a mensagem; ~menos de 10s, sem voz over). Qualquer coisa mais longa, narrada ou com várias cenas — ou qualquer incerteza → leia/hyperframesprimeiro: a camada de intenção possui cada decisão de rota.
Este workflow é autônomo por design — no máximo uma pergunta de esclarecimento (agents/director.md), depois construa até a verificação sem revisão intermediária. A camada de intenção (/hyperframes → references/intent-interview.md) roteia diretamente aqui sem perguntas de forma; um storyboard e sessão companheira acrescentam pouco a uma peça tão curta. A renderização ainda é controlada pelo usuário: após as verificações e snapshots de prova passarem, abra a pré-visualização do Studio e faça a pergunta canônica "renderizar agora, ou quais mudanças?" de ../hyperframes/references/brief-contract.md. Quando um BRIEF.md existir, leia-o antes da pergunta do diretor.
Um motion graphic curto e orientado pelo design. Asset-first: decida a estratégia de ativos e obtenha material real antes de projetar a cena, depois projete a cena em torno do que você tem, em seguida componha reutilizando capacidades do catálogo. Todos os artefatos vão para PROJECT_DIR = videos/<project-name>/ (criado no Passo 0); todos os caminhos abaixo são relativos a ele.
| Fase | Execução | Artefato primário | Fluxo detalhado |
|---|---|---|---|
| init | Bash | hyperframes.json | Passo 0 |
| plan | subagente — decidir pesquisa? + classificar + estratégia de ativos | shot-plan.json (rascunho: categoria, consultas asset_needs, brief) | agents/director.md (Parte 1) |
| source ◇ | Bash — resolver mídia-uso (pular se asset_needs estiver vazio) | assets/ + assets/index.md | phases/source/guide.md |
| design | subagente — design da cena em torno dos ativos resolvidos | shot-plan.json (final: block(s) + layout + movimento + posições) | agents/director.md (Parte 2) |
| build | subagente — composição com reúso primeiro | compositions/index.html | agents/builder.md |
| verify | Bash — lint, check, snapshots de prova; reparar em caso de falha | snapshots/contact-sheet.jpg | Passo 5 |
| approve | Abrir a pré-visualização; perguntar renderizar ou alterações; aguardar a resposta | aprovação explícita de renderização | Passo 6 |
| render | Bash — hyperframes render (MP4, ou --format webm/mov para sobreposição) | renders/video.mp4 ou sobreposição transparente | Passo 6 |
◇ source executa apenas quando a categoria escolhida declara ativos. Categorias puramente de código/texto (ex.: kinetic-type, a maioria charts/stat) têm asset_needs: [] e pulam direto do planejamento para o design.
Categorias — divididas pela decisão de pesquisa
A primeira decisão do plan é: isso precisa de uma pesquisa? Essa bifurcação divide as categorias em dois grupos; então a categoria específica é escolhida — para orientadas por pesquisa, pelo tipo de conteúdo que a pesquisa retorna. Cada categoria é um categories/<id>/module.md (suas regras de planejamento + construção); o vocabulário de movimento compartilhado vive em references/motion-vocabulary.md (→ regras/blueprints hyperframes-animation + blocos de registro).
Categorias de forma — sem pesquisa; o usuário fornece o conteúdo:
| Categoria | Intenção | Baseia-se em |
|---|---|---|
kinetic-type | linha/aspas/título impactante, texto com movimento em primeiro lugar | blocos caption-* + regras de animação |
stat | número herói único / contagem + anel | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | barra / linha / pizza / corrida / % a partir de dados | bloco data-chart |
logo-reveal | sting de logotipo / bloco de marca (logotipo do usuário) | logo-outro / rules/svg-path-draw |
lower-thirds | barras de nome/título, chamadas, sobreposições sociais | caption-* + blocos de sobreposição do registro |
maps | movimento geográfico — destacar regiões, conectar lugares, zoom para um local (via vetor, ou via mapa base assado) | família us-map / world-map + bake-basemap.mjs |
Categorias orientadas por pesquisa — pesquise primeiro, depois anime pelo tipo de conteúdo (caminho RWA):
| Conteúdo retornado | Categoria | Animação |
|---|---|---|
| webpage / link | webpage | animação de webpage / UI (scroll, revelar, cursor, chamadas) |
| artigo de notícia | news | revelação de manchete + cartão de fonte + chamadas de fatos-chave |
| tweet | tweet | cartão de tweet animado |
| imagem / entidade | asset-fusion | a geometria do ativo torna-se o gráfico (fusão diegética RWA) |
Ordem de construção: um de cada vez, cobertura primeiro (rascunho é suficiente). kinetic-type portado do protótipo; o restante segue.
Pré-requisitos
macOS Apple Silicon ou Linux x64. Ferramentas do sistema: brew install node ffmpeg. npx hyperframes doctor uma vez. Renderização GPU macOS: export PRODUCER_BROWSER_GPU_MODE=hardware.
Chaves opcionais (fallbacks locais se não definidas) — necessárias apenas por categorias que obtêm/geram ativos via mídia-uso:
| Chave | Usado para | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | geração de imagens (resolução de mídia-uso) | pular geração / apenas pesquisa |
| (asset_scout / provedores de pesquisa) | pesquisa de ativos reais para webpage/news/tweet + asset-fusion | categoria degrada para sem ativos |
Fluxo
Passo 0 — Inicializar
cwd é a raiz do workspace do agente; escreva todos os artefatos sob PROJECT_DIR = videos/<project-name>/. <project-name>: use o diretório que o usuário forneceu, senão um nome curto em kebab-case a partir da intenção (<assunto>-motion). Não o basename do workspace ou um timestamp.
Apenas quando $PROJECT_DIR/hyperframes.json estiver ausente:
PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics
init verifica os skills instalados em relação aos mais recentes no GitHub e atualiza o conjunto global se algum estiver desatualizado.
Restrições: nunca hyperframes init na raiz do workspace; nunca aninhe outro hyperframes/ dentro de PROJECT_DIR; todo comando Bash (mestre + subagentes) é um subshell (cd "$PROJECT_DIR" && ...) — nunca cd puro.
Passo 1 — Planejar (subagente: Diretor Parte 1)
Despache um subagente. prompt = agents/director.md completo + ## Contexto de despacho (SKILL_DIR / PROJECT_DIR / a solicitação do usuário / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Ele deve:
- Decidir: isso precisa de uma pesquisa? (a primeira bifurcação)
- Não → escolha uma categoria de forma (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps); o conteúdo é fornecido pelo usuário;
asset_needs: []. - Sim → emita um plano de pesquisa em
asset_needs[](notícia / web / tweet / imagem; consultas de dois polos). A categoria orientada por pesquisa específica (webpage / news / tweet / asset-fusion) é confirmada pelo tipo de conteúdo retornado no Passo 2 e finalizada no Passo 3.
- Não → escolha uma categoria de forma (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps); o conteúdo é fornecido pelo usuário;
- Escrever um rascunho
shot-plan.json(envelope + categoria de forma escolhida ou intenção de pesquisa +asset_needs+ um parágrafo de brief da cena). Schema:references/shot-plan-ir.md.
Validação: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo ausente.
Passo 2 — Obter ◇ (Bash: mídia-uso, condicional)
Se shot-plan.json.asset_needs não estiver vazio, resolva os ativos (pesquisar / gerar / buscar → caminhos locais congelados no projeto + ledger). Veja phases/source/guide.md (encapsula media-use resolve; as categorias orientadas por pesquisa usam a pesquisa de notícia/web/tweet/imagem). Se asset_needs estiver vazio, pule para o Passo 3.
Degrade graciosamente: se uma pesquisa/provedor não estiver disponível, a categoria recai para sem ativos (anote em context.log).
Passo 3 — Projetar (subagente: Diretor Parte 2)
Despache um subagente (prompt = agents/director.md Parte 2 + contexto de despacho incluindo o assets/index.md resolvido se o Passo 2 foi executado + catalog-map.md). Ele projeta a cena em torno dos ativos disponíveis: escolha o(s) bloco(s) do catálogo + as regras/blueprints hyperframes-animation, o layout, o movimento, os beats e (para asset-fusion) as element_positions + paleta conta-gotas. Finaliza shot-plan.json (content.block + content.customize + conteúdo por categoria).
Passo 4 — Construir (subagente: Builder, reúso primeiro)
Inclua os princípios de movimento compartilhados no contexto de despacho do Builder. Para charts e stat, inclua também dados em movimento. O Builder lê esses guias antes de escrever a timeline.
Despache um subagente. prompt = agents/builder.md completo + contexto de despacho (shot-plan.json, catalog-map.md, module.md da categoria, references/motion-vocabulary.md, references/builder-contract.md). Reúso primeiro: npx hyperframes add <block> + personalize no local; escreva manualmente apenas lacunas + a capacidade de fusão de ativos. Saída compositions/index.html respeitando o contrato HF (timeline GSAP pausada em window.__timelines, class="clip" + ids estáveis, tl.seek(0), determinístico).
Passo 5 — Verificar (Bash → subagente de reparo em caso de falha)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <tempos-de-prova>)
Escolha tempos de prova que mostrem o estado de abertura, o movimento característico e a parada final. Inspecione a folha de contato ou snapshot gerada antes de continuar. Em caso de falha em lint, check ou snapshot, despache o subagente de reparo (agents/finalize.md) para uma passagem de correção no local e, em seguida, reexecute a verificação com falha. Nunca altere uma duração fixa apenas para ocultar um defeito.
Passo 6 — Aprovar e renderizar (Bash)
Abra o Studio, depois faça uma pergunta: "renderizar agora, ou quais mudanças?" Após revisões, retorne ao mesmo ponto:
(cd "$PROJECT_DIR" && npx hyperframes preview --background)
Renderize apenas após uma resposta explícita de renderização:
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# variante de sobreposição transparente: --format webm (ou mov)
Verifique se a saída existe, não está vazia e tem a duração pretendida. O handoff final nomeia o artefato, a duração real, o ID da composição ou quadro, os tempos de prova e a folha de contato ou snapshot inspecionada. As flags estão em /hyperframes-cli → references/preview-render.md.
Tabela de retomada
| Estado | Continuar de |
|---|---|
sem shot-plan.json | Passo 1 (planejar) |
shot-plan.json tem asset_needs, sem assets/ | Passo 2 (obter) |
shot-plan.json final, sem compositions/index.html | Passo 3/4 (projetar+construir) |
compositions/index.html existe, snapshots de prova ausentes | Passo 5 (verificar) |
| verificações e snapshots de prova passam, sem renderização aprovada | Passo 6 (aprovação) |
| renderização aprovada existe | verificar saída, depois relatar |