Criar um Vídeo - A Skill do Iniciante ao MP4 Finalizado
Duas fases, oito portões sequenciais. Cada portão produz um artefato concreto que o próximo portão consome. Não pule portões.
Quando usar esta skill - e quando transferir
Use esta skill quando:
- O usuário é novo no HyperFrames e está começando a partir de um conceito, roteiro ou esboço
- Eles querem um passo a passo completo, não material de referência do framework
- Eles ainda não decidiram o formato
Transfira quando:
- O usuário colar uma URL e quiser um vídeo daquele site → invocar
/website-to-hyperframes - O usuário quiser explicitamente um vídeo vertical 9:16 com rosto (talking-head) + sobreposições de cena → execute os Portões 1–4 aqui, depois invoque
/short-form-videoa partir do Portão 5 - O usuário perguntar sobre regras do framework, não sobre um vídeo → invocar
/hyperframes
Nota de roteamento (pipeline AI Edit Video): quando esta skill for executada a partir de um resumo de projeto, as seções STYLE DESIGN e PHONG CÁCH DỰNG (estilo de vídeo) do prompt de edição substituem os padrões da entrevista abaixo - não refaça perguntas de estilo que o resumo já responde.
As duas fases
- Fase 1 - ENTREVISTA (Portões 1–4): uma passada conversacional para coletar tudo antes de tocar em código. Intenção, formato, roteiro, voz, estilo, ativos, ritmo. Sintetize em um
BRIEF.mde aguarde aprovação explícita. - Fase 2 - CONSTRUÇÃO (Portões 5–8): scaffolding → storyboard → composições → lint → pré-visualização no Studio → renderização de rascunho → verificação visual → pré-visualização do MP4 → renderização final.
Portão 1 · Intenção e formato
Faça uma pergunta de cada vez via AskUserQuestion, de múltipla escolha quando possível.
- Para que serve este vídeo? (promo · anúncio social · teaser de lançamento · demonstração de produto · tutorial · explicativo · cartão de intro/outro · outro)
- Quem é o público? (aberta)
- Duração alvo? (curto 10–20s · promo 20–45s · explicativo 45–90s · lição 1,5–3 min · personalizado)
- Proporção de tela? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
- Taxa de quadros? (30 padrão · 60 para UI nítida · 24 cinematográfica)
- Restrições de plataforma/entrega? (tamanho do arquivo · prazo · onde será reproduzido)
Portão: todos os seis capturados. Se a resposta for 9:16 + rosto (face-cam), planeje transferir para /short-form-video no Portão 5.
Banco de perguntas completo: Read: references/interview-questions.md
Portão 2 · Roteiro e voz
- Fonte do roteiro? (colar · esboço → eu redijo · eu gravo · TTS a partir de texto · sem narração)
- Se TTS: preferência de voz. Ofereça opções de
npx hyperframes tts --help. Capture também o ritmo.hyperframes tts(Kokoro) é apenas inglês - narração em vietnamita passa pelo/api/tts(Gemini TTS ou VieNeu) do sistema. - Se rosto (face-cam): caminho da gravação · posicionamento em tela cheia ou canto · precisa de transcrição? (
npx hyperframes transcribe <file> --model small.en --json- apenas inglês; para vietnamita use faster-whisper conforme a skill noti-tiktok-vn) - Legendas? (desligado · hype · corporativo · karaokê-palavra-por-palavra · minimalista)
Portão: roteiro capturado (ou redigido), plano de áudio capturado, plano de legendas capturado.
Portão 3 · Coleta de estilo
Antes de perguntar qualquer coisa ao usuário, faça um inventário dos ativos existentes. Verifique <workspace-root>/assets/ e qualquer pasta assets/ do projeto. Não pergunte pelo que já está lá.
Depois pergunte progressivamente - eles não precisam de respostas para tudo:
- Guia de estilo ou documento de marca? (colar/caminho · não)
- Paleta de cores? (códigos hex · nenhum - usar padrões do MOTION_PHILOSOPHY)
- Fontes? (nome(s) do Google Fonts · caminhos de arquivo · nenhum - usar padrões Inter + JetBrains Mono)
- Arquivo de logotipo? (caminho · nenhum). Se uma marca for nomeada, mas nenhum arquivo for fornecido: procure em
assets/brand-logos/, ou busque comPOST /api/brand-logos {"name":"..."}- uma marca de texto (wordmark) é permitida SOMENTE após um404 BRAND_LOGO_NOT_FOUND. Nunca desenhe ou gere um logotipo. - Vídeos de referência para o estilo? (URLs/caminhos · nenhum)
- Outros ativos? (capturas de tela · fotos do produto · b-roll · música - liste os caminhos)
- Estética MOTION_PHILOSOPHY (tela preta · texto cromado · grade de perspectiva · transições de whip) ou um estilo diferente?
- Ritmo? (cinético 1–2s · equilibrado 2–3s · relaxado 3–5s)
- Música? (nenhuma · pad ambiente 0.15 · base musical 0.4 · completa 0.8 - caminho do arquivo se eles tiverem um)
- Texto de encerramento / call-to-action?
Nunca imponha uma marca ao usuário. Recorra aos padrões do MOTION_PHILOSOPHY apenas quando eles declinarem explicitamente fornecer um estilo.
Fluxo de estilo completo + padrões MOTION_PHILOSOPHY: Read: references/style-intake.md
Portão 4 · Síntese do resumo (PORTÃO DURO antes da construção)
- Leia
MOTION_PHILOSOPHY.mdse existir na raiz do workspace - obrigatório se presente. Se estiver faltando, prossiga com os padrões emreferences/style-intake.mde anote a ausência no resumo. - Pergunte onde os projetos ficam se não for óbvio:
- Se
video-projects/existir → usevideo-projects/<slug>/ - Caso contrário → pergunte ao usuário
- Se
- Escreva
<project-folder>/BRIEF.md:- slug · intenção · público · dimensões · fps · duração
- roteiro (completo ou esboço)
- escolha de voz · plano de legendas · plano de rosto (face-cam)
- perfil de estilo: paleta (hex), fontes, caminho do logotipo, vídeos de referência
- ritmo
- inventário de ativos com caminhos
- texto de encerramento / CTA
- Mostre o resumo. AGUARDE aprovação explícita. Não prossiga para o Portão 5 sem um claro "sim, construa."
Portão 5 · Scaffolding e storyboard
Verificação de transferência primeiro
Se o resumo descrever um vídeo vertical 9:16 com rosto (talking-head) + sobreposições de cena, invoque /short-form-video AGORA e entregue o resumo. O scaffolding de 4 camadas dele é feito sob medida para esse formato.
Caso contrário, continue:
Scaffolding
mkdir <project-folder>- Se existir um projeto irmão com formato semelhante, ofereça copiar o
hyperframes.json+meta.jsondele como modelo. Caso contrário, de dentro da pasta:npx hyperframes init - Edite
meta.jsoncom o slug, dimensões e fps do usuário. - Copie os ativos fornecidos para
<project-folder>/assets/. - Crie
<project-folder>/assets/style-profile.mda partir do Portão 3 - fonte única da verdade para paleta/fontes/logotipo.
Storyboard
Gere <project-folder>/STORYBOARD.md usando o modelo em references/storyboard-template.md. Cada batida recebe:
Batida N - TÍTULO (início–fim, duração) - Conceito em uma frase
Elementos visuais: [cada elemento, tamanho, animação, temporização]
Linguagem de movimento: [tipo de movimento]
Eases usados: [3–4 eases GSAP distintos]
Saída: [transição para a próxima batida]
Áudio: [linha de VO / SFX / camada de música]
Topo do arquivo: uma tabela de temporização com cena · início · duração · arquivo de composição.
Proponha uma estrutura de regra de três:
- Ato 1 (gancho) ≈ 20% da duração
- Ato 2 (corpo) ≈ 55%
- Ato 3 (recompensa + encerramento com pausa de 4–6 segundos) ≈ 25%
(MOTION_PHILOSOPHY §0 Lei 9, §1.)
Mapeie intenções do usuário para blocos do catálogo: Read: references/catalog-intent-map.md
Portão: mostre o storyboard + tabela de temporização. Itere até o usuário aprovar.
Portão 6 · Construir composições
Invoque /hyperframes para regras do framework. Esta skill é dona do scaffolding e da disciplina; /hyperframes aplica as regras.
Scaffolding de cada sub-composição
<div data-composition-id="scene-name" data-start="..." data-duration="...">
<style>[data-composition-id="scene-name"] { /* escopado */ }</style>
<!-- DOM -->
<script>
(function(){
const SLOT_DURATION = ...;
const tl = gsap.timeline({ paused: true });
// ... tweens ...
tl.to({}, { duration: SLOT_DURATION }, 0); // âncora - MOTION_PHILOSOPHY Lei 11
window.__timelines["scene-name"] = tl;
})();
</script>
</div>
Boilerplate completo + padrão de legendas + padrão de fundo ambiente: Read: references/composition-scaffold.md
Regras de construção
- Fundo ambiente em
data-track-index="0"durante toda a duração da composição. - Aberturas de texto cinético: espaçamento por palavra de 0.06–0.10s.
- Legendas como irmãos de nível de corpo da composição raiz em
index.html, cada uma comdata-track-index ≥ 20. Nunca dentro das linhas do tempo das cenas (MOTION_PHILOSOPHY §3.13). - Blocos do catálogo instalados via
npx hyperframes add <name>. Imediatamente escope o CSS do bloco para[data-composition-id="..."]- blocos do catálogo vêm com regrashtml, body { ... }que vazam para o documento pai quando carregados como sub-composições. - Vertical + rosto (face-cam): envolva o rosto nativo 1920×1080 em uma transformação (
translate+scale) para modo metade inferior ou tela cheia. (Se você acabar aqui em vez de/short-form-video, considere fortemente a transferência.) - Aplique SOMENTE o que o usuário forneceu. A paleta deles, as fontes deles, o logotipo deles. Não injete mais nada. Se eles escolheram os padrões do MOTION_PHILOSOPHY, pegue a paleta + par de fontes de
references/style-intake.md.
Determinismo
Sem Math.random(), sem Date.now(), sem fetch() em tempo de renderização. Use PRNGs com semente ou hashes harmônicos seno (MOTION_PHILOSOPHY §3.10).
Portão 7 · Lint → Pré-visualização no Studio (PORTÃO DE PRÉ-VISUALIZAÇÃO 1 - OBRIGATÓRIO)
npx hyperframes lint- corrija todos os erros, trie os avisos.npx hyperframes previewem segundo plano.- Aguarde "Studio running" em
http://localhost:3002. - Entregue ao usuário a URL mais as URLs de composição individuais (
http://localhost:3002/?comp=<id>). Se o projeto tiver blocos de shader WebGL, comece com as URLs individuais - a fallback de software WebGL pode travar a composição mestre. - AGUARDE explícito "parece bom, renderize um rascunho" antes de prosseguir. Silêncio não é aprovação.
Hot reload está ligado - as edições aparecem ao vivo.
Portão 8 · Renderização de rascunho → Verificação visual → Pré-visualização MP4 → Final
Renderização de rascunho
npx hyperframes render --quality draft --output renders/<slug>-draft.mp4
Verificação visual (OBRIGATÓRIA antes da entrega)
Lint passando ≠ design funcionando. Extraia quadros e veja-os.
mkdir -p renders/frames- Para cada momento herói de batida E cada transição:
ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png - Chame a ferramenta
Readem cada PNG. A ferramenta Read carrega a imagem no contexto - não apenas liste nomes de arquivos. - Confirme por quadro: sem rostos cortados, modo de rosto correto por cena, texto legível e na paleta, sem estouro, transições aterrissam nas palavras pretendidas, sem quadros em branco.
- Se algo estiver errado: corrija → re-renderize → re-verifique. Nunca envie um rascunho quebrado.
Pré-visualização MP4 (PORTÃO DE PRÉ-VISUALIZAÇÃO 2 - OBRIGATÓRIO)
npx serve renders -p 8080 -n
NÃO use o http.server do Python - ele não suporta requisições HTTP Range, então o scrub (avanço/retrocesso) quebra.
Entregue ao usuário http://localhost:8080/<slug>-draft.mp4. AGUARDE autorização explícita sobre a reprodução e sincronia de áudio.
Renderização final
npx hyperframes render --quality standard --output renders/<slug>-final.mp4
No pipeline AI Edit Video este NÃO é o fim: continue com a skill video-pipeline (QC → montar final via fila de renderização → outputs/<id>-v<N>.mp4 → atualizar meta.json → miniatura/publicar). Uso independente fora do pipeline: reporte o caminho de saída. Pronto.
Lista de verificação completa de pré-voo e pré-entrega: Read: references/build-checklist.md
Inegociáveis (estruturais - não amenize)
- NÃO pule o PORTÃO DE PRÉ-VISUALIZAÇÃO 1 (Studio) ou o PORTÃO DE PRÉ-VISUALIZAÇÃO 2 (MP4 renderizado). Dois portões por construção, sempre.
- NÃO afirme que uma renderização está concluída até que os quadros tenham sido extraídos E lidos via a ferramenta Read.
- NÃO construa em nenhum outro lugar que não seja uma pasta de projeto dedicada. Nunca coloque
index.htmlna raiz do workspace. - NÃO peça ativos ao usuário antes de inventariar o workspace dele.
- NÃO pule o tween âncora
tl.to({}, { duration: SLOT_DURATION }, 0)no final de cada linha do tempo de sub-composição. MOTION_PHILOSOPHY Lei 11. - NÃO use
Math.random()/Date.now()dentro da lógica de renderização. Apenas hashes com semente. - NÃO adicione
class="clip"a tags<video>. Isso as quebra. - NÃO imponha uma marca ao usuário. Pergunte primeiro; recorra aos padrões do MOTION_PHILOSOPHY apenas quando eles declinarem explicitamente.
Referências
references/interview-questions.md- banco de perguntas completo por Portãoreferences/style-intake.md- entrevista de estilo + padrões MOTION_PHILOSOPHYreferences/catalog-intent-map.md- "usuário diz X → instale Y"references/storyboard-template.md- modelo batida por batida + exemplo práticoreferences/composition-scaffold.md- estilos escopados + boilerplate GSAP IIFEreferences/build-checklist.md- portões de pré-voo e pré-entrega
Externas (nível de workspace):
MOTION_PHILOSOPHY.md- a única referência externa que esta skill assume que existe. Linha de base estética. A fallback reside emreferences/style-intake.mdse o arquivo estiver faltando.
Skills relacionadas
/hyperframes- regras do framework, invocar no Portão 6/hyperframes-cli- init · lint · preview · render · transcribe · tts/hyperframes-registry- instalando blocos do catálogo/gsap- referência de animação GSAP/short-form-video- transferir no Portão 5 para formato 9:16 com rosto (talking-head)/website-to-hyperframes- transferir no Portão 1 se a entrada inicial for uma URL