Instalação de plugins: Antes dos comandos de setup ou atualização, siga as regras de execução de plugins 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 e sem efeitos quando tudo está atualizado; caso contrário, atualiza este skill e os skills de domínio principais dos quais ele depende, antes de você utilizá-los.
origem figma: Se o logotipo/ativo/animação a ser construído vem 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 — e depois construa a partir da sua saída. Não acione 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 de 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 gráfico em movimento 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 é dona de toda decisão 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 de formato de execução; um storyboard e uma 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 o que mudar?" de ../hyperframes/references/brief-contract.md. Quando um BRIEF.md existir, leia-o antes da pergunta do diretor.
Um gráfico em movimento curto e orientado pelo design. Ativos primeiro: decida a estratégia de ativos e obtenha material real antes de projetar o plano, depois projete o plano em torno do que você tem, então componha reutilizando 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, 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 — projetar plano em torno dos ativos resolvidos | shot-plan.json (final: bloco(s) + layout + movimento + posições) | agents/director.md (Parte 2) |
| construir | subagente — composição priorizando reutilização | compositions/index.html | agents/builder.md |
| verificar | Bash — lint, check, snapshots de prova; reparar em caso de falha | snapshots/contact-sheet.jpg | Etapa 5 |
| aprovar | Abrir a pré-visualização; perguntar renderizar ou alterações; aguardar a resposta | aprovação explícita de renderização | Etapa 6 |
| renderizar | Bash — hyperframes render (MP4, ou --format webm/mov para sobreposição) | renders/video.mp4 ou sobreposição transparente | Etapa 6 |
◇ fonte é executada apenas quando a categoria escolhida declara ativos. Categorias puramente de código/texto (ex.: kinetic-type, a maioria dos charts/stat) têm asset_needs: [] e pulam diretamente do plano para o design.
Categorias — divididas pela decisão de busca
A primeira decisão do plan é: isso precisa de uma busca? Essa ramificaçã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 vive em references/motion-vocabulary.md (→ regras/blueprints hyperframes-animation + blocos de registro).
Categorias de formulário — sem busca; o usuário fornece o conteúdo:
| Categoria | Intenção | Depende de |
|---|---|---|
kinetic-type | linha / citação / título impactante, texto com movimento como prioridade | 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 | vinheta de logotipo / selo 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, ampliar para um local (via vetorial, ou via mapa base fixo) | família us-map / world-map + bake-basemap.mjs |
Categorias orientadas por busca — busque primeiro, depois anime 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 (rolagem, revelação, 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 se torna o gráfico (fusão diegética RWA) |
Ordem de construção: um de cada vez, priorizando cobertura (aproximado é 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 para categorias que obtêm/geram ativos via media-use:
| Chave | Usado para | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | geração de imagens (resolução de media-use) | pular generate / apenas busca |
| (provedores de busca asset_scout) | webpage/news/tweet + busca de ativos reais asset-fusion | categoria degrada para sem ativos |
Fluxo
Etapa 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 (<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 execute hyperframes init na raiz do workspace; nunca aninhe outro hyperframes/ dentro de PROJECT_DIR; todo comando Bash (master + subagentes) é um subshell (cd "$PROJECT_DIR" && ...) — nunca cd puro.
Etapa 1 — Planejar (subagente: Diretor Parte 1)
Despache um subagente. prompt = agents/director.md completo + ## Contexto de despacho (SKILL_DIR / PROJECT_DIR / a requisição do usuário / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Ele deve:
- Decidir: isso precisa de uma busca? (a primeira ramificaçã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ícia / 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 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 plano de um parágrafo). Esquema:references/shot-plan-ir.md.
Validação: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.
Etapa 2 — Fonte ◇ (Bash: media-use, condicional)
Se shot-plan.json.asset_needs não estiver vazio, resolva os ativos (buscar / gerar / buscar → caminhos locais congelados do projeto + registro). Veja 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 um provedor de busca estiver indisponível, a categoria cai 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 o plano 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) os element_positions + a paleta do conta-gotas. Finaliza shot-plan.json (content.block + content.customize + conteúdo por categoria).
Etapa 4 — Construir (subagente: Construtor, priorizando reutilização)
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ê estes 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 reutilização: npx hyperframes add <block> + personalize no local; escreva manualmente apenas lacunas + a possibilidade 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).
Etapa 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 pausa 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, depois reexecute a verificação falhada. Nunca altere uma duração fixa meramente para esconder um defeito.
Etapa 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 de sobreposição 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, o ID da composição ou quadro, os tempos de prova e a folha de contato ou snapshot inspecionada. Sinalizadores vivem 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ê isto)
- Racionamento de ativos primeiro
…
[truncado para tradução]