motion-graphics — Entrada de Despacho
Confirme a rota antes do Passo 0. Esta skill cria um motion graphic curto, focado em design e sem narração (o movimento é a mensagem; ~menos de 10s, sem voz-over). Um tratamento mais longo, com múltiplas cenas ou narrado →
/general-video; um vídeo narrado de um site →/website-to-video; um explicador de tópico →/faceless-explainer; um promocional de produto →/product-launch-video; legendas em filmagens existentes →/embedded-captions. Fora do escopo: dados ao vivo / no momento da renderização, ou filmagens que não podem ser capturadas. Não tem certeza se é motion-first ou narrado? Leia/hyperframesprimeiro.
Um motion graphic curto e focado em design. Asset-first: 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, e então 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 pesquisa? + classificar + estratégia de ativos | shot-plan.json (rascunho: categoria, asset_needs consultas, briefing) | agents/director.md (Parte 1) |
| source ◇ | Bash — resolução de mídia (pule se asset_needs estiver vazio) | assets/ + assets/index.md | phases/source/guide.md |
| design | subagente — design do plano 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 |
| render | Bash — hyperframes render (MP4, ou --format webm/mov para overlay) | renders/video.mp4 | Passo 5 |
| verify | Bash — lint / inspect -> subagente de reparo em caso de falha | (correções no lugar) | agents/finalize.md |
◇ source é executado 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 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 as orientadas por pesquisa, pelo tipo de conteúdo que a pesquisa retorna. Cada categoria é um categories/<id>/module.md (suas regras de planejamento e construção); o vocabulário de movimento compartilhado está em references/motion-vocabulary.md (→ regras/blueprints de hyperframes-animation + blocos de registro).
Categorias de Formulário — sem pesquisa; o usuário fornece o conteúdo:
| Categoria | Intenção | Baseia-se em |
|---|---|---|
kinetic-type | linha impactante / citação / título, texto com foco em movimento | blocos caption-* + regras de animação |
stat | número herói único / contagem regressiva + círculo | 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, overlays sociais | caption-* + blocos de overlay do registro |
Categorias Orientadas por Pesquisa — pesquise 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 / interface (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 se torna o gráfico (fusão diegética RWA) |
Ordem de construção: um de cada vez, priorizando cobertura (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. Execute npx hyperframes doctor uma vez. GPU no 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 media-use) | 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
O diretório de trabalho é 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, caso contrário, um nome curto em kebab-case derivado 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
init verifica se as skills instaladas estão atualizadas em relação às últimas do 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 puro.
Passo 1 — Planejar (subagente: Diretor Parte 1)
Despache um subagente. prompt = conteúdo completo de agents/director.md + ## 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 formulário (kinetic-type / stat / charts / logo-reveal / lower-thirds); o conteúdo é fornecido pelo usuário;
asset_needs: []. - Sim → emita um plano de pesquisa em
asset_needs[](notícias / 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 formulário (kinetic-type / stat / charts / logo-reveal / lower-thirds); o conteúdo é fornecido pelo usuário;
- Escreva um rascunho de
shot-plan.json(envelope + categoria de formulário escolhida ou intenção de pesquisa +asset_needs+ um parágrafo de briefing do plano). Esquema:references/shot-plan-ir.md.
Validação: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.
Passo 2 — Source ◇ (Bash: media-use, condicional)
Se shot-plan.json.asset_needs não estiver vazio, resolva os ativos (pesquisar / gerar / buscar → caminhos locais congelados do projeto + registro). Veja phases/source/guide.md (encapsula media-use resolve; as categorias orientadas por pesquisa usam a pesquisa de notícias/web/tweet/imagem). Se asset_needs estiver vazio, pule para o Passo 3.
# ilustrativo — veja phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)
Degrade graciosamente: se uma pesquisa/provedor estiver indisponível, a categoria cai para o modo 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 o plano em torno dos ativos disponíveis: escolha o(s) bloco(s) do catálogo + as regras/blueprints de 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).
Passo 4 — Construir (subagente: Construtor, priorizando reuso)
Despache um subagente. prompt = conteúdo completo de agents/builder.md + contexto de despacho (shot-plan.json, catalog-map.md, o module.md da categoria, references/motion-vocabulary.md, references/builder-contract.md). Priorizando reuso: npx hyperframes add <block> + personalize no lugar; escreva manualmente apenas lacunas + a affordance de asset-fusion. 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ística).
Passo 5 — Renderizar (Bash)
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# variante de overlay transparente: --format webm (ou mov)
Passo 6 — Verificar (Bash → subagente de reparo em caso de falha)
(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)
exit 0 → concluído. Em erros de lint/inspect, despache o subagente de reparo (agents/finalize.md: snapshot QA + uma passagem de correção no lugar + re-renderizar). Nunca altere uma duração fixa no reparo.
Relatório + pré-visualização opcional
Relate a saída final (renders/video.mp4, ou a variante .webm / .mov de overlay) + duração. Não abra uma pré-visualização durante a execução. Ofereça uma apenas mediante solicitação, iniciada após a renderização para que sirva o arquivo final:
(cd "$PROJECT_DIR" && npx hyperframes preview) # UI do Studio; ou `npx hyperframes play` para um link compartilhável
Flags estão na skill 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 (source) |
shot-plan.json final, sem compositions/index.html | Passo 3/4 (projetar+construir) |
compositions/index.html existe, sem renders/video.mp4 | Passo 5 (renderizar) + Passo 6 |
renders/video.mp4 existe | Relatar + Parar |
Notas de Design (mantenedores — a execução não lê isto)
- Racional Asset-first: a obtenção de ativos é carregada no início e informa o design do plano (o fluxo RWA: analisar → pesquisar → revisar → compor). As categorias orientadas por pesquisa (
webpage/news/tweet) easset-fusiondependem da pesquisa media-use (notícias/web/tweet/imagem), que é a linhagem RWA documentada do media-use. - Reuso-first: o análogo no ecossistema de templates gerados por LLM é "compor blocos do catálogo + regras de
hyperframes-animation". A linha do tempo GSAP pausada do HF é análoga aouseCurrentFramedo Remotion. - Contrato do módulo de categoria: um
categories/<id>/module.md(planejamento + construção), compartilhandoreferences/motion-vocabulary.md(+ avaliação opcional). Adicionar uma categoria = soltar a pasta + registrar sua linha de classificação emagents/director.md+ sua linha emcatalog-map.md; o pipeline de fases não é tocado. - Estrutura de diretórios:
videos/<project-name>/ hyperframes.json context.log shot-plan.json # O IR (saída do Diretor) assets/ assets/index.md # saída do media-use (se obtido) compositions/index.html # saída do Construtor renders/video.mp4 - Registro: no roteador
hyperframes— adicione a intenção "motion graphic curto focado em design" + descrição do Workflow; remova os gatilhos de motion-graphics de/general-video; adicione arestas reversas de NÃO-USAR. Vejamotion-graphics-genre.md§5-7.