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. Tudo roda na sua máquina; você só descreve o que quer.

Estúdio de gravação com câmera em dolly e iluminação
O que é

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

Catorze 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 reutilizáveis

Cards com tokens CSS e slots de texto, templates de papel quadriculado escuro e glass popout, tudo animado com GSAP e renderizado pelo HyperFrames.

📱 Reels, Shorts e vídeos longos

Fluxo dedicado para 9:16 com gancho, recompensa, legendas precisas e B-roll, e outro para a edição completa de uma aula ou tutorial.

Como funciona

Cinco etapas, em loop até ficar pronto

O agente transcreve, corta, planeja os beats (cada cena é um beat), gera as cenas em HTML animado e verifica o resultado com screenshots e escuta das junções. Se algo estiver fora, volta e ajusta.

Transcrever Cortar silêncios e erros Planejar beats Gerar HTML + GSAP Verificar e renderizar

edit-video

Orquestra a edição completa de uma gravação: transcrição, cortes, história, cards e verificação.

short-form-edit

Reels e Shorts 1080x1920 com plano de cenas, legendas por palavra, ledger de footage e validadores.

cut-silences · cut-mistakes

Uma etapa só: tirar pausas ou revisar erros. Sempre nessa ordem, com a transcrição retemporizada.

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.

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

Transcrição (opcional)

ElevenLabs Scribe é o padrão. Whisper local ou OpenAI Whisper são alternativas; peça ao assistente.

# .env na raiz
ELEVENLABS_API_KEY=sua-chave
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        # 11 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

Configurar a transcrição

Na ElevenLabs: Developers → API keys → crie uma chave restrita a speech_to_text e cole no .env. Se preferir Whisper, 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 completa

Crie o projeto, coloque a gravação em assets/raw.mp4 e descreva o resultado. Quanto mais específico (estilo, cenas, onde entra cada elemento), mais próximo 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,
proponha os cortes de erro para eu revisar, planeje a história e monte um draft
com o estilo papel quadriculado escuro e glass cards ocasionais.
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

Verificar, dar feedback e virar skill

Rode preflight e lint, revise no Studio, renderize o draft e assista. Devolva feedback concreto como faria com um editor. Quando o resultado ficar do seu jeito, peça para virar uma 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
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 e o guia rápido estão em docs/.
Roadmap

Onde o kit está e para onde vai

A versão 2 consolidou o pipeline e o kit original num repositório só. Os próximos passos são de curadoria e de exemplos 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; 14 skills sincronizadas e 406 cards validados.
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
Estilo INEMA na bibliotecaUm terceiro estilo de cards (dark âmbar) com tokens, DESIGN.md e previews, além de skills de transcrição local por padrão.