Edição de Vídeo — Pipeline de Demonstração Legendada
Editor de vídeo legendado completo, baseado no HyperFrames. O usuário fornece um vídeo; você orquestra transcrição → revisão → renderização e SEMPRE pausa para aprovação da transcrição antes da renderização longa.
Onde esta skill se encaixa na pirâmide YUV.AI
video-edit está no nível intermediário da pirâmide de skills YUV.AI, ao lado de yuv-design-system, yuv-decks, yuv-viral-video, parallax-landing-page e video-to-landing-page. O orquestrador de nível superior yuv-pilot roteia para cá sempre que o usuário quer uma demonstração legendada, tutorial ou edição com locução e legendas.
Esta é a skill irmã, mais geral, de yuv-viral-video. A divisão:
yuv-viral-video— pipeline opinativo de vídeos virais curtos da YUV.AI (ritmo MrBeast, estilo editorial exclusivo)video-edit— editor legendado geral com transcrição-revisão-antes-renderização (hebraico + inglês + qualquer idioma do Whisper)
Para vídeos legendados com a marca YUV.AI, combine esta skill com yuv-design-system (modo Neon para decisões de tipografia/paleta). Para vídeos legendados genéricos/de terceiros, esta skill funciona sozinha.
Quando invocar
- Um caminho para um arquivo de vídeo (mp4/mov/mkv) + um pedido para "editar", "legendar", "adicionar legendas", "fazer um reel/promo", "fazer igual"
- "Corrigir as legendas / erros de hebraico" — reentre na etapa de revisão em um projeto existente
- Qualquer construção de tutorial / locução / promo legendado
Local de salvamento
Padrão: ~/Documents/yuv-projects/videos/<slug>/ — sempre salve projetos de vídeo legendado aqui para que as renderizações sejam encontráveis. O <slug> é curto, derivado do tópico ou nome do arquivo de origem.
mkdir -p ~/Documents/yuv-projects/videos
cd ~/Documents/yuv-projects/videos
# Inicialize o projeto aqui.
A renderização final é salva em ~/Documents/yuv-projects/videos/<slug>/renders/<name>_FINAL.mp4. Informe ao usuário onde o vídeo está ao final da renderização.
Fluxo de trabalho (12 etapas)
-
Analisar a origem —
ffprobepara dimensões, fps, duração, áudio. -
Estruturar —
cd ~/Documents/yuv-projects/videos && npx hyperframes init <slug> --video <path> --non-interactive. Renomeie o vídeo copiado parasource.mp4. -
Extrair áudio —
ffmpeg -i source.mp4 -vn -ac 1 -ar 16000 audio.wav. -
Transcrever — copie
references/transcribe.pypara o projeto. Modelo padrãolarge-v3(melhor hebraico). CUDA geralmente falha no Windows (falta cuDNN); o script usa fallback para CPU int8. Forcelanguage="he"para hebraico,language="en"para inglês; caso contrário, detecção automática. -
Aplicar correções conhecidas — copie o conteúdo de
references/corrections-hebrew.mdpara umcorrections.jsonna raiz do projeto (chaves = token errado, valores = token correto). -
🛑 PARE — inicie o servidor de revisão e deixe o usuário aprovar em um webapp. Primeiro aplique as correções conhecidas: copie
references/make_review.pypara o projeto e executepython make_review.py. Ele aplicacorrections.jsonatranscript.json.Em seguida, inicie o servidor de revisão como uma tarefa em segundo plano (ele bloqueia até que o usuário clique em "Aprovar e Renderizar" no navegador):
python "$HOME/.claude/skills/video-edit/references/serve_review.py" . # No Windows: python "C:\Users\<você>\.claude\skills\video-edit\references\serve_review.py" .O servidor imprime uma linha como
REVIEW_URL=http://localhost:PORT/. Pegue essa URL da saída da tarefa em segundo plano (ou leia o stdout) e envie ao usuário:👉 Revise sua transcrição aqui: http://localhost:PORT/ Quando clicar em Aprovar e Renderizar, continuarei automaticamente.
O agente não precisa de uma mensagem "continuar" — quando o usuário clica no botão, o servidor escreve
transcript_review.txtno diretório do projeto E sai com código 0. A notificação de tarefa em segundo plano do agente é acionada e o pipeline é retomado da etapa 8.Fallback se não houver navegador / servidor: abra o editor como um arquivo estático (
start "" "$HOME/.claude/skills/video-edit/transcript-editor/index.html"), peça ao usuário para selecionar a pasta do projeto, editar, salvartranscript_review.txtde volta no projeto e responder "continuar". O editor suporta ambos os modos. -
(Opcional) Remoção de fundo — veja a etapa 7 abaixo; pode ser executada em paralelo com a revisão do usuário.
-
Após a aprovação, execute
python references/apply_review.py. Ele re-tokeniza as linhas editadas e redistribui os tempos das palavras de volta paratranscript.jsonpara que a sincronia das legendas ainda funcione. -
(Opcional) Remoção de fundo — se algum segmento com locução precisar de texto atrás do sujeito, extraia o segmento como
outro.mp4(ouintro.mp4) e executenpx hyperframes remove-background <clip>.mp4 -o <name>_subject.webm --quality best. Apenas CPU na maioria das configurações (~3–8 min para um clipe de ~15s em 1440p). -
Recodificar origem com keyframes densos — a renderização multi-worker trava em keyframes esparsos. Sempre execute:
ffmpeg -y -i source.mp4 -c:v libx264 -preset medium -crf 18 -r 30 -g 30 -keyint_min 30 -sc_threshold 0 -pix_fmt yuv420p -movflags +faststart -c:a copy footage.mp4 -
Recarregue a transcrição (editada) e gere a sub-composição do corpo via
references/gen_body.py. O gerador emite ocompositions/components/caption-body.htmlcompleto com estilo editorial + matriz alternados em pílulas de vidro líquido, ancorado no canto inferior esquerdo central (limpa os PiPs da webcam no canto inferior direito). -
Conecte o
index.htmldo host a partir dereferences/host-template.html. Ordem das camadas (z-index, NÃO track-index):- z0: footage
.cam-bg - z1: fundo de bolhas líquidas (
compositions/liquid-blobs.html,mix-blend-mode: screen, duração total) - z2: legenda parallax atrás do sujeito (intro e/ou outro, quando a remoção de fundo é usada)
- z3: recorte do sujeito
.cam-out/.cam-sub(comdata-media-startcorrespondente) - z6: legendas do corpo
- z46: barra de progresso + flash + transição líquida morph
- z0: footage
-
Lint —
npx hyperframes lint. Deve ter 0 erros. Correções comuns: conflito de transformação CSS/GSAP no elemento de transição (usexPercent/yPercentou remova a transformação CSS); tweens sobrepostos na mesma propriedade (adicioneoverwrite: "auto"). -
Renderizar —
npx hyperframes render --quality standard --fps 30 --output renders/<name>_FINAL.mp4. "Standard" é o alvo de entrega correto —highaproximadamente dobra o tempo de renderização. Verifique com 6–8 quadros de verificação ao longo da linha do tempo antes de relatar a conclusão.
Saída vertical (9:16) para TikTok / Reels / Shorts
Quando o usuário solicitar saída vertical / retrato / TikTok / Reels / 9:16 (a partir de uma fonte 16:9):
- Clone o projeto para uma pasta irmã:
cp -r project/ project-vertical/. - Substitua seu
index.htmlporreferences/host-template-vertical.html(tela 1080×1920, fundo desfocado com bolhas líquidas, a imagem 16:9 como uma faixa horizontal centralizada, legendas abaixo). - Substitua seu
gen_body.pyporreferences/gen_body_vertical.py(pílula centralizada, fontes maiores, largura máxima mais estreita) e reexecute-o para emitircompositions/components/caption-body.html. - Remova as sub-composições de recorte atrás do sujeito + parallax (o recorte está alinhado para 16:9; não vale a pena realinhar para v1). A composição vertical usa o fundo desfocado da origem + bolhas para atmosfera.
- Atualize
data-durationpara a duração real do vídeo. Atualize o texto do chip da marca emindex.html(YUV.AIpor padrão). - Lint + renderize — mesmos comandos. A saída é
1080×1920. Publicação direta no TikTok / IG Reels / YT Shorts.
Para entregar ambos 16:9 e 9:16 de uma só vez, execute dois comandos de renderização (em projetos paralelos). A aprovação do transcript_review.txt se aplica a ambos — mesmas legendas, duas composições.
Regras críticas
- Nunca renderize o final sem aprovação explícita da transcrição. A etapa de revisão é o ponto principal.
- Para hebraico:
large-v3+language="he"+direction: rtl+ Rubik (700 + 900 para ênfase editorial de peso duplo). - As pílulas de legenda sempre precisam de um fundo escuro opaco — texto claro sem fundo desaparece na interface branca do aplicativo.
- Centralize as pílulas de legenda horizontalmente, mas desloque a coordenada x do centro para a esquerda (ex.:
left: 720px) quando a imagem tiver um PiP da webcam no canto inferior direito. - O clipe de recorte atrás do sujeito DEVE ter
data-media-startcorrespondente ao seudata-start(ou correspondente ao deslocamento da origem se o clipe foi extraído), senão o recorte reproduz a partir do quadro 0 e dessincroniza. - O webm
remove-backgroundmantém o RGB original e escreve apenas a máscara alfa —ffproberelatayuv420p, que parece "sem alfa". Confirme viaTAG:ALPHA_MODE=1ou sobreponha sobre uma cor sólida. - Cartões de finalização/saída com texto gravado — NÃO coloque legendas sobre eles; eles colidem.
Referências de arquivos
| Arquivo | Propósito |
|---|---|
transcript-editor/index.html | Editor interativo no navegador — visualização de vídeo, edição RTL, aplicação de dicionário, sugestões opcionais de IA WebLLM, salva transcript_review.txt |
references/setup.md | Pré-requisitos + comandos de instalação para Node / Python / FFmpeg / faster-whisper |
references/transcribe.py | Transcrição faster-whisper com fallback de CPU + timestamps de palavras |
references/serve_review.py | Servidor de revisão local — carrega automaticamente o editor, bloqueia até o usuário clicar em Aprovar e Renderizar, então escreve transcript_review.txt e sai (sinaliza o agente) |
references/make_review.py | Aplicar correções + emitir transcript_review.txt (fallback em modo arquivo) |
references/apply_review.py | Analisar o arquivo de revisão editado, redistribuir timestamps de palavras, atualizar transcript.json |
references/gen_body.py | Gerador do corpo da legenda (editorial + matriz em pílulas de vidro líquido) |
references/host-template.html | Composição do host 16:9 com efeitos líquidos + transição de wipe |
references/host-template-vertical.html | Host 9:16 (1080×1920) — layout para TikTok / Reels / Shorts: fundo desfocado, faixa de vídeo 16:9 centralizada, legendas abaixo, chip da marca no canto superior direito |
references/gen_body_vertical.py | Gerador do corpo da legenda ajustado para vertical (pílula centralizada, fontes maiores, largura máxima mais estreita) |
references/liquid-blobs.html | Camada de bolhas flutuantes com duração total |
references/caption-parallax-outro.html | Modelo de legenda atrás do sujeito (inglês; clone para outros idiomas) |
references/corrections-hebrew.md | Erros comuns de transcrição do Whisper em hebraico |
references/transcript-review-workflow.md | A etapa de pausa/aprovação em detalhes |