Instalação de plugins: Antes de comandos de configuração ou atualização, siga as regras de execução de plugins quando este skill estiver dentro de um plugin HyperFrames. Instalações autônomas 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 sem alterações quando tudo está atualizado; caso contrário, ele atualiza este skill e os skills de domínio principal dos quais depende antes de você utilizá-los.
fonte figma: Se o logotipo/ativo/animação para construir 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 Figma Motion — depois construa a partir de sua saída. Não controle o Figma diretamente por meio de ferramentas MCP brutas: 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
A porta de entrada é
/hyperframes. Este skill cria um gráfico de movimento curto, focado em design e sem narração (movimento é a mensagem; ~abaixo 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 toda decisão de rota.
Este fluxo de trabalho é autônomo por design — no máximo uma pergunta de esclarecimento (agents/director.md), depois construa através da verificação sem revisão intermediária. A camada de intenção (/hyperframes → references/intent-interview.md) roteia aqui diretamente sem perguntas sobre o formato da execução; um storyboard e uma sessão de acompanhamento acrescentam pouco a uma peça tão curta. A renderização ainda é controlada pelo usuário: após as verificações e as capturas de tela de prova passarem, abra a visualização do Studio e faça a pergunta canônica "renderizar agora, ou o que mudar?" de ../hyperframes/references/brief-contract.md. Quando um BRIEF.md existir, leia-o antes da pergunta do diretor.
Um gráfico de movimento curto e focado em design. Ativos primeiro: decida a estratégia de ativos e obtenha material real antes de projetar a cena, então projete a cena em torno do que você tem, depois 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 principal | Fluxo detalhado |
|---|---|---|---|
| init | Bash | hyperframes.json | Passo 0 |
| plan | subagente — decidir busca? + classificar + estratégia de ativos | shot-plan.json (rascunho: categoria, consultas asset_needs, brief) | agents/director.md (Parte 1) |
| fonte ◇ | Bash — resolver uso de mídia (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: bloco(s) + layout + movimento + posições) | agents/director.md (Parte 2) |
| build | subagente — composição com reuso primeiro | compositions/index.html | agents/builder.md |
| verify | Bash — lint, check, capturas de tela de prova; reparo em falha | snapshots/contact-sheet.jpg | Passo 5 |
| aprovar | Abrir a visualização; perguntar renderizar ou alterações; aguardar resposta | aprovação explícita de renderização | Passo 6 |
| render | Bash — hyperframes render (MP4, ou --format webm/mov para overlay) | renders/video.mp4 ou overlay transparente | Passo 6 |
◇ fonte é executado apenas quando a categoria escolhida declara ativos. Categorias puramente de código/texto (por exemplo, kinetic-type, a maioria dos charts/stat) têm asset_needs: [] e passam diretamente do planejamento para o design.
Categorias — divididas pela decisão de busca
A primeira decisão do plan é: isso precisa de uma busca? Essa bifurcação divide as categorias em dois grupos; então a categoria específica é escolhida — para busca orientada, pelo tipo de conteúdo que a busca retorna. Cada categoria é um categories/<id>/module.md (suas regras de planejamento + construção); o vocabulário de movimento compartilhado está em references/motion-vocabulary.md (→ regras/blueprints do hyperframes-animation + blocos de registro).
Categorias de formulário — sem busca; o usuário fornece o conteúdo:
| Categoria | Intenção | Baseia-se em |
|---|---|---|
kinetic-type | linha impactante / citação / título, texto com movimento primeiro | blocos caption-* + regras de animação |
stat | número herói único / contagem crescente + anel | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | gráfico de barras / linhas / pizza / corrida / % a partir de dados | bloco data-chart |
logo-reveal | sting de logotipo / lockup 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 de registro |
maps | movimento geográfico — destacar regiões, conectar lugares, ampliar para um local (via de vetor, ou via de mapa base assado) | família us-map / world-map + bake-basemap.mjs |
Categorias orientadas por busca — buscar primeiro, depois animar por tipo de conteúdo (o caminho RWA):
| Conteúdo retornado | Categoria | Animação |
|---|---|---|
| página web / link | webpage | animação de página web / UI (scroll, revelar, cursor, chamadas) |
| artigo de notícias | 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 uso de mídia:
| Chave | Usada para | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | geração de imagem (resolução de uso de mídia) | pular geração / apenas busca |
| (asset_scout / provedores de busca) | busca de ativos reais para webpage/news/tweet + asset-fusion | categoria degrada para sem ativos |
Fluxo
Passo 0 — Inicializar
O diretório de trabalho atual é 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 derivado da intenção (<subject>-motion). Não o nome base 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 simples.
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 busca? (a primeira bifurcação)
- Não → escolha uma categoria de formulário (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps); o conteúdo é fornecido pelo usuário;
asset_needs: []. - Sim → emita um plano de busca em
asset_needs[](notícias / web / tweet / imagem; consultas de dois polos). A categoria orientada por busca 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 formulário (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps); o conteúdo é fornecido pelo usuário;
- Escreva um rascunho de
shot-plan.json(envelope + categoria de formulário escolhida ou intenção de busca +asset_needs+ um brief de cena de um parágrafo). Schema:references/shot-plan-ir.md.
Validação: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.
Passo 2 — Fonte ◇ (Bash: uso de mídia, condicional)
Se shot-plan.json.asset_needs não estiver vazio, resolva ativos (buscar / gerar / buscar → caminhos locais congelados do projeto + registro). Veja phases/source/guide.md (envolve media-use resolve; as categorias orientadas por busca usam a busca de notícias/web/tweet/imagem). Se asset_needs estiver vazio, pule para o Passo 3.
Degrade com elegância: se uma busca/provedor estiver indisponível, a categoria cai 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) de catálogo + as regras/blueprints do hyperframes-animation, o layout, o movimento, as batidas e (para asset-fusion) os element_positions + paleta de conta-gotas. Finaliza shot-plan.json (content.block + content.customize + conteúdo por categoria).
Passo 4 — Construir (subagente: Builder, reuso 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 linha do tempo.
Despache um subagente. prompt = agents/builder.md completo + contexto de despacho (shot-plan.json, catalog-map.md, o module.md da categoria, references/motion-vocabulary.md, references/builder-contract.md). Reuso primeiro: npx hyperframes add <block> + personalize no local; escreva manualmente apenas lacunas + a facilidade de fusão de ativos. Saída compositions/index.html honrando o contrato HF (linha do tempo GSAP pausada em window.__timelines, class="clip" + ids estáveis, tl.seek(0), determinístico).
Passo 5 — Verificar (Bash → subagente de reparo em falha)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)
Escolha tempos de prova que mostrem o estado de abertura, o movimento característico e a espera final. Inspecione a folha de contato ou captura gerada antes de continuar. Em falha de lint, check ou captura, 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 meramente para ocultar um defeito.
Passo 6 — Aprovar e renderizar (Bash)
Abra o Studio, depois faça uma pergunta: "renderizar agora, ou o que mudar?" Após revisões, retorne à mesma verificação:
(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 overlay transparente: --format webm (ou mov)
Verifique se a saída existe, não está vazia e tem a duração pretendida. A entrega final nomeia o artefato, duração real, composição ou id do quadro, tempos de prova e a folha de contato ou captura inspecionada. Sinalizadores 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 (fonte) |
shot-plan.json final, sem compositions/index.html | Passo 3/4 (projetar+construir) |
compositions/index.html existe, capturas de prova ausentes | Passo 5 (verificar) |
| verificações e capturas de prova passam, sem renderização aprovada | Passo 6 (aprovação) |
| renderização aprovada existe | verificar saída, depois relatar |
Notas de design (mantenedores — a execução não lê isso)
- Ativos primeiro