O gate — antes de qualquer composição
Gatilho literal: a entrega É um arquivo de mídia renderizado. MP4, WebM, MOV, PNG. Formato da entrega, nunca aparência.
Não ativa esta skill:
- Vídeo usado dentro de um site — hero, background, depoimento. Isso é um asset web
comum, tratado como qualquer imagem ou fonte (ver
referencias/assets.md). - Peça de UI animada que "parece vídeo" mas é interativa — é motion ou 3D de interface, não render.
A distinção é de formato da entrega. Se o resultado abre no navegador e responde a clique, não é esta skill.
Formato, resolução, fps e duração não têm default
Escolher "1080p 30fps porque é comum" é exatamente o que o gate existe para impedir. Os quatro campos — formato, resolução, fps e duração — sobem ao usuário antes de a composição começar.
Custo operacional — confirme antes de comprometer
HyperFrames não é um import: é um processo de produção. Depende de Chrome e FFmpeg instalados, e a captura pode ser distribuída.
Confirme que a infraestrutura existe antes de prometer a rota. Descobrir na hora do render que falta FFmpeg é descobrir depois de a composição inteira estar escrita.
Render nunca é automático
Nenhuma execução de render acontece sem autorização explícita do usuário. Render consome tempo de máquina e, quando há geração de mídia envolvida, dinheiro real.
Quando faltar um asset e a alternativa for gerar: nomeie o que falta e o que geraria — e pare ali.
Como usar
frontend-video/
├── SKILL.md ← este arquivo. O ÚNICO sempre lido
└── referencias/
├── hyperframes.md o gate, formato/fps/duração, tempo determinístico,
│ adapters, captions, autorização de render
├── direcao-visual.md tokens com razão escrita, anti-genérico
├── assets.md origem, licença, otimização — aqui o asset É a entrega
└── validacao.md os gates aplicáveis à mídia
| Sua tarefa | Abra |
|---|---|
| decidir formato, resolução, fps, duração | hyperframes.md §3 |
| conteúdo, fontes, captions, direitos | hyperframes.md §4 |
| tempo determinístico, saída reproduzível, adapters de cena | hyperframes.md §5 |
| acessibilidade e performance da peça | hyperframes.md §6 |
| autorizar o render | hyperframes.md §7 |
| direção estética da composição | direcao-visual.md |
| licença de imagem, fonte, trilha | assets.md |
| fechar a entrega | validacao.md |
Sempre ignorar: SEO, DOM indexável, jornada de navegação e estados de aplicação — mídia determinística não tem nenhum dos quatro. Runtime web como entrega final também não se aplica: aqui o navegador é ferramenta de captura, não o destino.
Reprodutibilidade — o que "determinístico" realmente exige
O engine torna a composição buscável por tempo. Isso sozinho não garante saída idêntica.
Prometer arquivo byte a byte reproduzível exige fixar todos estes: HyperFrames, Chrome, FFmpeg, fontes, assets, codec e flags, resolução, fps, duração e ambiente. Mesmo commit sem esse lock não autoriza a promessa.
Fonte auditada: repositório heygen-com/hyperframes, commit
af1cb1c10da33bade100db8233435c7591b7c0bc, pacotes principais 0.8.17 nesse commit,
licença Apache-2.0 na raiz e no CLI. Verificado em 2026-08-28. Reauditar se a versão mudar
ou se a composição depender de capacidade não coberta pelas fichas.
O que vale sempre
- Conteúdo real, nunca inventado — sem placeholder que pareça final.
- Captions e contraste fazem parte da entrega, não são extra.
- Validação no output real, nunca no preview. O que o preview mostra e o que o arquivo final contém divergem — codec, cor e timing entre eles.
- Código de cena autoral continua responsável pelo próprio disposal. Cena Three/WebGL dentro da composição precisa de teardown como em qualquer outro lugar.