Codex · Claude Code · HyperFrames · GSAP

Sua gravação vira um vídeo editado por um agente

Transcreve, corta silêncios e erros, planeja as cenas e monta motion graphics em HTML animado. Você descreve o que quer, em português, e o agente verifica o próprio trabalho antes de entregar.

Mesa de edição escura com uma timeline de vídeo brilhando e uma película que vira código HTML
O que é

Um kit de skills para editar vídeo com IA, em português

Quinze skills espelhadas para Codex e Claude Code, 406 cards de motion graphics em dois estilos, dois templates de cena, validadores e um starter que roda sem chave de API.

✂️ Cortes guiados por transcrição

Remove silêncios, gagueiras, falsos começos e retakes com marcação por palavra. Cada corte proposto é revisado em contexto antes de aplicar.

🧩 Motion graphics na hora certa

Cards com tokens CSS e slots de texto, ancorados na frase exata da fala. Um validador confere se cada elemento entra no momento em que você fala dele.

🎞️ Da aula ao showreel

Edição completa de aulas, reels e Shorts 9:16, e showreels de marca de 15 segundos cortados no tempo da música.

O método

Cinco etapas, em ciclo até ficar bom

É o raciocínio por trás do kit. Cada etapa tem uma skill ou um script. O detalhe está em docs/METODO.md.

1 · Transcrever→ 2 · Cortar→ 3 · Planejar os beats→ 4 · Usar e criar skills→ 5 · Verificar em ciclo
1

Transcrever

Tempo por palavra: é o que faz cada gráfico entrar na hora certa e o agente entender a história. ElevenLabs Scribe ou Whisper local.

2

Cortar

Ar morto e erros saem antes de qualquer design, com cut-silences e depois cut-mistakes. Serve até se você for terminar no seu editor.

3

Planejar os beats

"Quando eu disser X, mostre Y." Quanto mais claro o combinado, mais perto do que você quer. video-storytelling e hyperframes-video-beats.

4

Usar e criar skills

Tudo o que você repete vira skill. A cada rodada, diga o que gostou e o que não gostou e mande atualizar a skill.

5

Verificar em ciclo

O agente renderiza, extrai quadros, olha, corrige e só entrega depois de algumas voltas. Você recebe a versão 5, não a 1.

★

Referência → skill

Gostou de um vídeo? Meça com analyze-reference.mjs, peça a análise do porquê funciona e transforme em skill. Assim nasceu a motion-showreel.

Receitas de prompt

O que pedir, com as palavras certas

Descreva o resultado e até a emoção que o vídeo deve causar. O agente acrescenta ideias próprias; revise como faria com um editor. Todas as receitas estão em docs/PROMPTS.md.

🎯 Ancorado na fala

Cada elemento amarrado a uma frase, com posição e card de vidro para dar leitura.

Quando eu citar [A] e [B], mostre [A] onde eu
aponto à esquerda e [B] à direita, com os logos
animados e um card de vidro atrás. Quando eu
disser "[tese]", mostre as palavras embaixo,
destacadas. Verifique o render antes de entregar.

📸 Provar ao vivo

O agente busca o material: grava a tela, tira screenshots, usa imagens reais e gera o que faltar.

Quando eu falar de B-roll, screenshots ou geração
de imagem, faça de verdade: grave a tela, tire o
screenshot, gere a imagem, e mostre nas laterais
com um fundo que garanta a leitura.

🖍️ Uma gravação, três estilos

Quadro branco desenhado à mão; estilo curso com câmera em círculo e tópicos grandes; ou short dinâmico com B-roll.

Edite [gravação] como aula. A câmera começa em
tela cheia e depois fica num recorte circular.
Fundo minimalista, poucos tópicos grandes e
imagens simples geradas por IA.

🎉 Sizzle de uma pasta

Uma pasta de gravações de evento vira um reel com as falas que mostram a energia do público.

Veja tudo em [pasta], transcreva as falas e monte
um sizzle de [duração] contando a história do
evento. Me mostre a seleção de falas antes.

🛍️ Vídeo de produto

Imagens reais do catálogo, fotos geradas a partir delas e vídeos curtos dessas fotos, no tempo da música.

Faça um vídeo de [duração] para [produto] com
imagens reais do catálogo. Onde faltar movimento,
gere foto e vídeo (Kling pela minha assinatura).
Confirme antes de gastar créditos.

✨ Showreel de marca

A skill motion-showreel: um motivo que se transforma em capítulos, HUD, cortes na grade de tempos e lockup do logo.

Use motion-showreel para um showreel de 15 s
de [marca]. Meça a grade de tempos, mapeie os
capítulos para objetos da marca e me mostre o
storyboard antes de construir.
Pré-requisitos

O que precisa estar instalado

Node.js 22+, Git, FFmpeg com ffprobe e Chrome ou Chromium. O starter e os testes não precisam de nenhuma chave paga.

Ferramentas locais

Confira que estão no PATH do terminal.

# versões
node -v   # 22 ou mais
ffmpeg -version
ffprobe -version

Assistente

Codex (app desktop ou CLI) ou Claude Code. As skills são descobertas sozinhas ao abrir a pasta. Para edições completas, use esforço alto.

# Claude Code, dentro da pasta
claude
# Codex: New project → Local → pasta do kit

Serviços (opcionais)

Transcrição: ElevenLabs Scribe ou Whisper local. Vídeo gerado: sua assinatura Kling pelo CLI kling; Kie.ai só como alternativa paga.

# .env na raiz
ELEVENLABS_API_KEY=sua-chave
# Kling: sem chave, login OAuth
kling login
Guia de uso · passo a passo

Do clone ao primeiro vídeo editado

Os comandos abaixo são os do repositório. No Codex use $skill; no Claude Code, /skill.

1

Instalar o kit

Clona, instala as dependências fixas (HyperFrames 0.7.109 e GSAP 3.14.2), confere as ferramentas e roda os testes.

git clone https://github.com/inematds/hyperframes-student-kit.git
cd hyperframes-student-kit
npm ci
npm run setup   # checa node, ffmpeg, chrome e cria o .env
npm test        # testes sem chave de API
2

Renderizar o exemplo sem gravação

Cria um projeto com a composição sintética, abre o Studio para scrub e renderiza um MP4 de oito segundos.

npm run demo
cd video-projects/demo
npx hyperframes lint
npx hyperframes preview   # Studio em localhost; Ctrl+C para sair
npx hyperframes render --quality draft --output renders/demo.mp4
3

Transcrever

Na ElevenLabs: Developers → API keys → crie uma chave restrita a speech_to_text e cole no .env. Se preferir Whisper local, diga ao assistente e ele configura.

# transcrição com marcação por palavra, ao lado do vídeo
node scripts/transcribe-elevenlabs.mjs video-projects/meu-video/assets/raw.mp4
4

Pedir a edição com beats ancorados

Crie o projeto, coloque a gravação em assets/raw.mp4 e diga o que aparece em cada fala. Quanto mais específico, mais perto do que você imagina.

npm run new-video -- meu-video
# no assistente:
Use edit-video em video-projects/meu-video/assets/raw.mp4. Corte pausas e erros e
me mostre os cortes de erro. Quando eu disser "[frase]", mostre [elemento] à direita
com um card de vidro atrás. Estilo papel quadriculado escuro. Verifique antes de entregar.
5

Ou uma etapa de cada vez

Silêncios primeiro, depois a revisão de erros usando o vídeo já cortado e a transcrição retemporizada. Nunca misture tempos originais com o vídeo editado.

node .claude/skills/cut-silences/scripts/cut-silences.mjs assets/raw.json --video assets/raw.mp4 --out-dir assets --output assets/silenced.mp4 --apply
node .claude/skills/cut-mistakes/scripts/find-cut-candidates.mjs assets/raw.silence-transcript.json --out-dir assets
# revise, escreva approved-cuts.json, então:
node .claude/skills/cut-mistakes/scripts/apply-cuts.mjs assets/raw.silence-transcript.json --cuts assets/approved-cuts.json --video assets/silenced.mp4 --out-dir assets --output assets/clean.mp4 --apply
6

Reel ou Short em 9:16

O fluxo short-form planeja gancho e recompensa, legendas exatas e B-roll, e tem validadores de plano e de footage.

Use short-form-edit para transformar video-projects/meu-reel/assets/raw.mp4 em um reel 9:16.
Gancho verdadeiro, legendas precisas, B-roll com propósito e sound design. Prepare um draft.
npm run validate:short-form -- video-projects/meu-reel
npm run validate:footage -- video-projects/meu-reel
7

Showreel cortado na música

Meça a grade de tempos da música (sua ou gratuita), gere a folha de quadros e deixe a skill montar os capítulos. Os scripts de áudio são locais, só FFmpeg.

node .claude/skills/motion-showreel/scripts/music-grid.mjs assets/audio/musica.mp3 --bpm 128 --beats
node .claude/skills/motion-showreel/scripts/beatgrid.mjs --period 0.4644 --length 15 --chapters "01 Physics:4, 02 Type:8, Flurry:4, 07 End:rest"
node .claude/skills/motion-showreel/scripts/mix.mjs --bed music-bed.wav --events events.json --out master.wav
8

Verificar, dar feedback e virar skill

Rode preflight e lint, revise no Studio, renderize o draft e assista. Devolva feedback concreto. Quando gostar de um resultado, ou de um vídeo de outra pessoa, peça para virar skill e sincronize o espelho do Codex.

node scripts/preflight.mjs video-projects/meu-video
node scripts/validate-beat-sync.mjs video-projects/meu-video
node .claude/skills/motion-showreel/scripts/analyze-reference.mjs referencia.mp4 qa/ref --fps 6 --bpm 128
npm run sync:skills   # depois de editar .claude/skills/
Exemplos

O que sai do kit

Referências de enquadramento e da proposta. As fotos de apresentador do repositório são simuladas; traga sua própria gravação para os exercícios.

Apresentadora em estúdio, enquadramento 9:16
Enquadramento 9:16 de talking-head: o ponto de partida de um reel com legendas por palavra e cards no terço superior.
Capa: acabou, é o fim de uma era
Capa do tutorial em vídeo que acompanha o kit. A transcrição traduzida, o guia rápido e o método estão em docs/.
Roadmap

Onde o kit está e para onde vai

O kit junta o pipeline de edição, as skills do original e o método do tutorial. Os próximos passos são exemplos e estilos em português.

Feito
Tradução e neutralizaçãoDocumentação, guia de trabalho e transcrição do tutorial em PT-BR; fotos de apresentador simuladas; skills sincronizadas e 406 cards validados.
Feito
Skill motion-showreelTrazida do kit original (set/2026) e traduzida: showreels cortados na música, com música e SFX gratuitos e o objeto herói pela assinatura Kling; Kie.ai e ElevenLabs como opções pagas.
Feito
Método e receitasAs cinco etapas, o prompt ancorado na fala, uma gravação em três estilos, sizzle de pasta, vídeo de produto e o ciclo referência → skill, em docs/METODO.md e docs/PROMPTS.md.
Próximo
Exemplo completo em portuguêsUma gravação de aula editada de ponta a ponta com o kit, com VERIFY.md e render de referência.
Depois
Novos estilos na bibliotecaDark âmbar INEMA, quadro branco e estilo curso como estilos de cards, com tokens, DESIGN.md e previews.