Instalação de plugins: Antes de comandos de configuração ou atualização, siga as regras de execução de plugins quando esta skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
Primeiro, mantenha esta skill atualizada — confirme com o usuário antes de executar:
npx hyperframes skills update motion-graphics. Uma operação rápida e sem efeitos quando tudo está atualizado; caso contrário, atualiza esta skill e as skills de domínio principal das quais ela depende antes de você usá-las.
fonte figma: Se o logotipo/ativo/animação a ser criado 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 manipule o Figma diretamente via ferramentas MCP brutas: isso ignora a sanitização de SVG, a proveniência de.media/manifest.jsonle a vinculação devar()de tokens de marca, portanto uma alteração posterior de marca não pode ser propagada sem uma reimportação completa.
motion-graphics — ponto de entrada
A porta de entrada é
/hyperframes. Esta skill cria um motion graphic curto, orientado pelo design e sem narração (o movimento é a mensagem; ~menos de 10s, sem voz sobreposta). Qualquer coisa mais longa, narrada ou com múltiplas cenas — ou qualquer incerteza → leia/hyperframesprimeiro: a camada de intenção é responsável por todas as decisões de rota.
Este fluxo de trabalho é autônomo por design — no máximo uma pergunta esclarecedora (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 sobre a forma de 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 provas de snapshot passarem, abra a pré-visualização do Studio e faça a pergunta canônica "renderizar agora, ou quais alterações?" 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. Ativos primeiro: 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 e, em seguida, componha reutilizando as capacidades do catálogo. Todos os artefatos vão para PROJECT_DIR = videos/<project-name>/ (criado na Etapa 0); todos os caminhos abaixo são relativos a ele.
| Fase | Execução | Artefato principal | Fluxo detalhado |
|---|---|---|---|
| init | Bash | hyperframes.json | Etapa 0 |
| plan | subagente — decidir busca? + classificar + estratégia de ativos | shot-plan.json (rascunho: categoria, consultas asset_needs, resumo) | agents/director.md (Parte 1) |
| fonte ◇ | Bash — resolução 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 priorizando reuso | compositions/index.html | agents/builder.md |
| verify | Bash — lint, check, provas de snapshot; reparo em caso de falha | snapshots/contact-sheet.jpg | Etapa 5 |
| approve | Abrir a pré-visualização; perguntar renderizar ou alterações; aguardar resposta | aprovação explícita de renderização | Etapa 6 |
| render | Bash — hyperframes render (MP4, ou --format webm/mov para overlay) | renders/video.mp4 ou overlay transparente | Etapa 6 |
◇ fonte é executada apenas quando a categoria escolhida declara ativos. Categorias puramente de código/texto (ex.: kinetic-type, a maioria de charts/stat) têm asset_needs: [] e pulam direto 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; em seguida, a categoria específica é escolhida — para as orientadas por busca, 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 hyperframes-animation + blocos de registro).
Categorias de forma — sem busca; o usuário fornece o conteúdo:
| Categoria | Intenção | Baseia-se em |
|---|---|---|
kinetic-type | frase/citação/título impactante, texto com movimento em primeiro plano | blocos caption-* + regras de animação |
stat | número herói único / contagem regressiva + 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 | logotipo / brand lockup (logotipo do usuário) | logo-outro / rules/svg-path-draw |
lower-thirds | barras de nome/título, callouts, overlays sociais | caption-* + blocos de overlay do registro |
maps | movimento geográfico — destacar regiões, conectar lugares, zoom em um local (faixa vetorial ou faixa de mapa base rasterizado) | família us-map / world-map + bake-basemap.mjs |
Categorias orientadas por busca — busque primeiro, depois anime por tipo de conteúdo (caminho RWA):
| Conteúdo retornado | Categoria | Animação |
|---|---|---|
| página web / link | webpage | animação de página web / UI (scroll, revelar, cursor, callouts) |
| artigo de notícias | news | revelação de manchete + cartão de fonte + callouts de fatos-chave |
| tweet | tweet | cartão de tweet animado |
| imagem / entidade | asset-fusion | a geometria do ativo se transforma no gráfico (fusão diegética RWA) |
Ordem de construção: um de cada vez, priorizando cobertura (rascunho é aceitável). 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 para categorias que obtêm/geram ativos via uso de mídia:
| Chave | Usada para | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | geração de imagens (resolução de uso de mídia) | pular geração / apenas busca |
| (provedores de busca de ativos) | busca de ativos reais para webpage/news/tweet + asset-fusion | categoria degrada para sem ativos |
Fluxo
Etapa 0 — Inicializar
cwd é a raiz do workspace do agente; escreva todos os artefatos em 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 use 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 as skills instaladas em relação às mais recentes no GitHub e atualiza o conjunto global se alguma estiver desatualizada.
Restrições: nunca execute 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.
Etapa 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 forma (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 bipolares). A categoria orientada por busca específica (webpage / news / tweet / asset-fusion) é confirmada pelo tipo de conteúdo retornado na Etapa 2 e finalizada na Etapa 3.
- Não → escolha uma categoria de forma (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 forma escolhida ou intenção de busca +asset_needs+ um resumo de cena de um parágrafo). Schema:references/shot-plan-ir.md.
Validação: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.
Etapa 2 — Fonte ◇ (Bash: uso de mídia, condicional)
Se shot-plan.json.asset_needs não estiver vazio, resolva os ativos (busca / geração / obtenção → caminhos locais congelados do projeto + ledger). Consulte phases/source/guide.md (encapsula media-use resolve; as categorias orientadas por busca usam a busca de notícias/web/tweet/imagem). Se asset_needs estiver vazio, pule para a Etapa 3.
Degrade graciosamente: se uma busca/provedor não estiver disponível, a categoria retorna para sem ativos (anote em context.log).
Etapa 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 a Etapa 2 foi executada + catalog-map.md). Ele projeta a cena em torno dos ativos disponíveis: escolha o(s) bloco(s) do catálogo + as regras/blueprints do hyperframes-animation, o layout, o movimento, os beats e (para asset-fusion) as element_positions + paleta de conta-gotas. Finaliza shot-plan.json (content.block + content.customize + conteúdo por categoria).
Etapa 4 — Construir (subagente: Construtor, priorizar reuso)
Inclua os princípios de movimento compartilhados no contexto de despacho do Construtor. Para charts e stat, inclua também dados em movimento. O Construtor 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). Priorizar reuso: npx hyperframes add <block> + personalize no local; escreva manualmente apenas lacunas + o recurso de fusão de ativos. Saída compositions/index.html respeitando o contrato HF (linha do tempo GSAP pausada em window.__timelines, class="clip" + ids estáveis, tl.seek(0), determinístico).
Etapa 5 — Verificar (Bash → subagente de reparo em caso de 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 pausa final. Inspecione a folha de contato ou snapshot gerada antes de continuar. Em caso de falha de 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 esconder um defeito.
Etapa 6 — Aprovar e renderizar (Bash)
Abra o Studio e, em seguida, faça uma pergunta: "renderizar agora, ou quais alterações?" Após revisões, retorne à mesma verificação:
(cd "$PROJECT_DIR" && npx hyperframes preview --background)
Renderize somente 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 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, a duração real, a composição ou id do frame, os tempos de prova e a folha de contato ou snapshot inspecionada. Flags estão em /hyperframes-cli → references/preview-render.md.
Tabela de retomada
| Estado | Continuar de |
|---|---|
sem shot-plan.json | Etapa 1 (planejar) |
shot-plan.json tem asset_needs, sem assets/ | Etapa 2 (fonte) |
shot-plan.json final, sem compositions/index.html | Etapa 3/4 (projetar+construir) |
compositions/index.html existe, snapshots de prova ausentes | Etapa 5 (verificar) |
| verificações e snapshots de prova passam, sem renderização aprovada | Etapa 6 (aprovação) |
| renderização aprovada existe | verificar saída, depois relatar |
Notas de design (mantenedores — a execução não lê isso)
- Racionamento de ativos primeiro