Vídeo curto dual-formato
Converte um tema, um roteiro ou uma notícia em dois MP4 — vertical 1080×1920 e horizontal 1920×1080 — gerados a partir de uma única fonte. A locução define o ritmo; todo o resto depende dela.
Antes de tudo: se o tema é uma notícia
Verifique os fatos com pesquisa web antes de escrever uma única linha de roteiro. Um vídeo informativo com dados falsos é o pior resultado possível desta skill, e é uma falha silenciosa: o vídeo sai igualmente bonito.
Se a premissa da solicitação não se sustenta, diga e monte o que realmente aconteceu. Não "suavize" o roteiro para encaixar em uma premissa falsa. Leia references/periodismo.md antes de tocar no roteiro: ele cobre verificação, tratamento de imagens em peças informativas e o arquivo de rastreabilidade.
O fluxo
npm run voz -- <slug> # script.json → assets/voice/*.wav + manifest de tempos
npm run imagens -- <slug> # images.json → B-roll gerado
npm run stock -- <slug> # stock.json → fotografia real (opcional, pago)
npm run audio -- <slug> # audio.json → música e efeitos
npm run build -- <slug> # plan.json → vertical.html + horizontal.html
npm run use -- <slug> vertical
npm run check # obrigatório: 0 erros antes de renderizar
npm run render -- <slug> # renders/<slug>-<formato>.mp4
Se o projeto ainda não existe: npx hyperframes@latest init . --non-interactive --example blank, copie scripts/ e assets/ desta skill e adicione os scripts do package.json. Requer Node 22+ e ffmpeg. Chaves no .env (modelo em assets/env.example).
Estrutura
videos/_shared/vox.css, timeline.js compartilhados por TODOS os vídeos
videos/<slug>/
script.json roteiro — uma linha = um corte
images.json prompts de B-roll gerado
stock.json consultas de fotografia real
audio.json música e efeitos
plan.json a montagem: beats que referenciam linhas do roteiro
scenes/*.html sub-composições animadas de uso único
assets/ o que é gerado + manifests com os tempos reais
vertical.html, horizontal.html GERADOS por build.mjs — não editar
As duas ideias que sustentam tudo
1. O roteiro manda no relógio. voice.manifest.json traz o start e a duration reais de cada linha. Um beat de plan.json referencia linhas, não segundos. Nunca estime durações de olho: mude o roteiro, regenere a voz e a montagem se reposiciona sozinha.
2. Os shells são artefatos. Com dezenas de cortes em dois formatos, sincronizá-los manualmente é inviável. build.mjs gera os dois a partir do mesmo plan.json, então eles não podem divergir: a única diferença é o tamanho do palco. Edite plan.json e reconstrua.
Para que uma cena valha em 9:16 e 16:9: modele em vw/vh/vmin, nunca px fixos; a raiz de uma sub-composição não leva data-width/data-height (a caixa é definida pelo slot do host); e estilize por #root, nunca por uma classe — o escopo do compilador a descarta. Para layouts que mudam de eixo, @media (min-aspect-ratio: 1/1).
Tipos de beat
stat (número protagonista com contagem ascendente via countTo) · compare (dois números confrontados) · title (kicker + título + entrada) · quote (citação + atribuição) · photo (imagem em tela cheia com gradiente, texto e crédito) · capture (captura de tela inteira, com sua fonte, como prova do que se afirma) · scene (sub-composição animada de uso único).
Para vídeos sobre uma empresa ou um produto, o logotipo e uma captura da fonte melhoram muito o resultado: ambos em references/imagens.md.
O erro de design mais comum: o carrossel de rótulos
Um vídeo feito apenas de cartões de texto entedia, por melhor que seja a tipografia. Quando notar que se acumulam title e stat seguidos, a solução não é mais texto: é movimento com significado.
assets/scenes/ traz nove cenas animadas em SVG prontas para adaptar: olas, puntos, barras, mapa, cierre, orbita (corpos orbitando), precos (tabela antes→depois), caida (uma queda com sua porcentagem) e indice (ranking com barras). Copie a que encaixar para videos/<slug>/scenes/ e altere os dados. Detalhes e regras de desempenho em references/escenas-animadas.md.
Alterne: número → foto → cena animada → citação → foto. E varie o enquadramento em cada corte (kb: "in" / "out" alterna o Ken Burns).
Ritmo
Beats de 2 a 6 s em um explainer de três minutos; de 0,8 a 2,5 s em um short. Cada beat dura até o próximo começar, para que não haja quadros pretos. Entradas com fromTo(), nunca from(): o host rebusca a cena a cada seek e from() dessincroniza.
Voz com emoções
eleven_multilingual_v2 ignora as tags. Para direcionar a interpretação, use "modelId": "eleven_v3" e tags em minúsculo entre colchetes, inline:
{ "id": "l19", "text": "[somber] Sessenta e sete pessoas morreram." }
Ajuste o registro ao tema — em uma notícia com vítimas, nada de [excited]. Catálogo de tags, ajustes e como verificar que não são lidas em voz alta: references/audio.md.
Antes de dar como bom
npm run check deve sair com 0 erros. Depois, assista ao vídeo: extraia quadros (ffmpeg -ss <t> -i <mp4> -frames:v 1) ou use npx hyperframes snapshot --at 12,40,90, que também gera uma folha de contato. O linter não vê que um plano está preto, que um texto sai do limite ou que uma foto não é o que diz ser.
Referências
references/hyperframes.md— as restrições do framework que quebram o render em silêncio. Leia antes de escrever composições.references/audio.md— ElevenLabs: voz com tags v3, música, efeitos, faixas.references/imagens.md— gpt-image-2 e Apify, com o controle de custo.references/periodismo.md— verificação e tratamento de imagens em notícias.references/escenas-animadas.md— as nove cenas SVG, como criar novas e as duas armadilhas que custam uma tarde (colisão de classes comvox.csse GSAP reescrevendo otransformdos SVGs).references/sistema-visual.md— a paleta e a tipografia do estilo explainer.