Communitygithub.com

reel-from-raw

Transforma um vídeo bruto de cabeça falante (Hinglish ou Inglês, vertical 9:16) em um Reel editado para Instagram usando Remotion, com cortes de silêncio, zoom, títulos 3D, painéis de terminal, vazamentos de luz, efeitos sonoros e cartão de seguir.

O que é reel-from-raw?

Este skill automatiza a produção de Reels (videos curtos verticais) a partir de um vídeo bruto de cabeça falante, utilizando a biblioteca Remotion. Ele é projetado para desenvolvedores que desejam criar edições de alta qualidade sem esforço manual. O processo inclui transcrição, corte de silêncios, geração de um roteiro de beats, e construção da edição final com componentes prontos como títulos 3D, painéis de terminal, vazamentos de luz e efeitos sonoros. O skill funciona no macOS, Linux e Windows WSL, e segue regras rígidas de segurança: não renderiza o vídeo completo sem permissão, não baixa conteúdo sem consentimento do usuário, e mantém o rosto do apresentador nas zonas seguras da tela. Ele é ideal para transformar vídeos técnicos ou explicativos em conteúdo envolvente para redes sociais, suportando loops de feedback com verificação visual e de som antes da renderização final.

Funciona com✓Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/pawantekchandani/reel-from-raw/tree/HEAD/skills/reel-from-raw

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Reel a partir de vídeo bruto

Comprovado em dois reels: Linux Day 2 e Linux Day 1 (com efeitos sonoros). library/Reel.tsx é o reel do Day 1. Copie seus padrões. Não invente um novo estilo.

Funciona no macOS e no Linux / Windows WSL. Configuração: veja README.md no repositório.

Regras estritas

  1. Cada sobreposição é temporizada a partir de work/words.txt em segundos. Nunca adivinhe um tempo.
  2. Use apenas componentes em src/ (biblioteca). Adicione um novo componente somente quando nenhum componente da biblioteca se encaixa em um beat.
  3. Mantenha o rosto visível. Zonas seguras (1080x1920):
    • Tags e títulos no topo: y 90 a 400.
    • Rosto e pescoço: y aproximadamente 450 a 1350. Nada aqui, exceto cartões de título em tela cheia (máx. 3 s).
    • Todo o resto vai abaixo do pescoço (primeiro botão da camisa): y 1360 a 1880. O Panel começa em BELOW_NECK (1360). Use fit para dimensionar um painel alto para que ele termine por volta de 1880.
    • Encontre a linha do pescoço para cada novo vídeo: capture um quadro com uma grade y e observe. Atualize BELOW_NECK em ui.tsx.
  4. Não renderize o vídeo completo a menos que o usuário peça no chat. Use scripts/stills.sh para verificar. Um hook bloqueia remotion render sem RENDER_OK=1.
  5. Não baixe nada (modelos, fontes, músicas, pacotes de som) sem perguntar ao usuário.
  6. Leia reference/known-problems.md antes de depurar qualquer coisa.
  7. No OpenCode, o plugin ~/.config/opencode/plugins/reel-from-raw faz o mesmo trabalho que os hooks Claude (bloqueio de render, verificação de tipo, lembrete de stills). Abra as imagens da folha com a ferramenta de leitura. Se seu modelo não conseguir ver imagens, peça ao usuário para verificar as folhas.

Regras de escopo (siga exatamente)

  1. Faça apenas o que o usuário pediu. Altere apenas os arquivos e valores que a solicitação precisa.
  2. Uma verificação (verificação de tipo, verificação de stills, lembrete de um hook ou plugin) é apenas uma verificação. Corrija apenas o que quebra uma regra neste arquivo ou em reference/style-spec.md. Nunca reformate, adicione um componente, adicione uma cena, ou altere texto, temporização ou volume por causa de uma verificação.
  3. Se você acha que algo mais deve mudar, diga ao usuário em uma linha. Não mude.
  4. Nunca edite ~/.claude/skills/reel-from-raw/ (este skill) enquanto trabalha em um vídeo. Edite apenas o projeto de vídeo.
  5. Um arquivo de teste que você criar (por exemplo src/__probe.ts) deve ser deletado antes de terminar.

Fluxo de trabalho (novo vídeo)

Execute cada etapa. Cada script imprime OK: em caso de sucesso. Pare e corrija em qualquer ERROR.

#EtapaComando / ação
1Criar projetobash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4> (por exemplo ~/Coding/motion-videos/<name>). Ele copia a biblioteca, os arquivos de som e os hooks, e instala os pacotes npm (ou os clona de $REEL_SEED).
2Transcreverbash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi (use en para inglês apenas). Em seguida, corrija erros de audição com reference/glossary.md.
3Cortar silênciospython3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>. Use --start/--end para descartar um falso início ou final.
4Folha de beatsSiga reference/beat-sheet-prompt.md. Escreva work/beats.md. Mostre ao usuário se ele quiser aprovar o plano.
5Construirsrc/Reel.tsx é o reel do Day 1. Reescreva-o a partir da folha de beats. Em Root.tsx, defina id (por exemplo LinuxDay3) e o handle real. Exclua componentes de cena que o reel não usa. Mantenha os helpers At e r().
6Verificação de tipoAutomática: um hook executa tsc --noEmit após cada edição. Corrija todos os erros que ele reportar.
7Verificação visualbash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto, depois leia cada out/stills/sheet*.jpg. Também verifique quadros de beat: stills.sh <dir> 120,450,.... Verifique em relação a reference/style-spec.md. Corrija e repita.
8Verificação de somOs efeitos sonoros vêm com os componentes (veja "Efeitos sonoros"). Verifique se public/sfx/typing.wav e public/sfx/pop.wav existem. Não adicione sons fora da tabela a menos que o usuário peça.
9Pré-visualizaçãoAdicione uma entrada launch.json executando npx remotion studio --no-open --port <free> no projeto. Dê ao usuário a URL http://localhost:<port>. O usuário ouve os sons lá.
10Renderizar (apenas sob solicitação)RENDER_OK=1 npx remotion render <Id> out/<name>.mp4 --gl=angle (execute em segundo plano, cerca de 3-5 min para 90 s).

Efeitos sonoros

src/sfx.tsx guarda cada som. SFX lista os sons. <Sfx src at volume frames name> reproduz um som at quadros dentro da Sequência atual.

Chave em SFXFonteInternet necessária
whoosh, ding, click, switch, whip@remotion/sfx (arquivos em remotion.media)Sim, para Studio e render
poppublic/sfx/pop.wav (criado por código)Não
typingpublic/sfx/typing.wav (criado por scripts/make-typing-sound.py)Não

Os componentes da biblioteca já reproduzem esses sons. Você não os adiciona manualmente.

MomentoArquivo (no projeto)SomVolume
Título do gancho / sub-chipscenes/Intro.tsx (Hook)whoosh / whip0.54 / 0.48
Cartão de título do diascenes/Intro.tsx (DayTitle)whoosh / ding0.6 / 0.36
Chips da lista de comandosscenes/Intro.tsx (CommandList)pop por chip0.36
Tag de comando / nome do comandoscenes/Commands.tsx (CommandTag)whoosh / switch0.54 / 0.48
Linhas do bloco de notasscenes/Commands.tsx (NoteCard)typing por linha0.6
Painel inferior apareceui.tsx (Panel)pop0.48
Comando do terminal digitadoui.tsx (Terminal)typing para cada linha de comando0.6
Vazamento de luzReel.tsxwhoosh0.48
Emblema "Concluído" / Clique em Seguirscenes/Outro.tsx (DayDone, FollowCard)ding / click0.48 / 0.72
Qualquer <Sfx> sem volumesfx.tsx (padrão)-0.42

O volume varia de 0 (silêncio) a 1 (máximo). Mantenha todo som abaixo da voz.

Solicitações comuns (receita exata)

Usuário pedeFaça exatamente isso
"Aumentar / diminuir todos os efeitos sonoros em N%"Multiplique cada volume={x} em uma linha <Sfx, e o padrão em sfx.tsx, por (1 ± N/100). Arredonde para 2 casas decimais. Não toque em CutVideo.tsx (essa é a voz). Execute grep -rn "<Sfx" src antes e depois, e mostre os valores alterados.
"Alterar apenas o volume do som do teclado / digitação"Altere apenas as linhas com src={SFX.typing} (ui.tsx Terminal e scenes/Commands.tsx NoteCard).
"Alterar apenas o som X"Encontre sua linha na tabela acima. Altere apenas aquele volume.
"O som do teclado está fraco / crie um novo"python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <project>/public/sfx/typing.wav. Mantenha uma cópia do arquivo antigo primeiro. Edite os números no script apenas se o usuário pedir uma sensação diferente.
"Remover um som"Exclua aquela linha <Sfx .../>.
"Onde posso ouvir antes de renderizar?"Studio (etapa 9). Pressione play ou Espaço. O Studio recarrega sozinho após cada edição salva.
"Como faço para renderizar sozinho?"Terminal: cd <project> && npx remotion render <Id> out/<name>.mp4 --gl=angle. Interface do Studio: Botão Render (extremidade direita da barra acima da linha do tempo) → guia Vídeo → defina Nome de saída → Renderizar vídeo. O progresso é mostrado na guia Trabalhos. A configuração OpenGL já é angle.
"Renderize isso"Etapa 10, com RENDER_OK=1. Em seguida, forneça o caminho completo do arquivo de saída.
"Alterar o handle"Root.tsx defaultProps.handle.

Como a temporização funciona

  • src/timeline.ts: CUTS (segundos brutos removidos), out(sec) mapeia um segundo bruto para um quadro de saída.
  • <At from={rawSec} to={rawSec} name="..."> mostra um bloco para aquela duração falada.
  • r(t0, t) fornece um atraso de quadro dentro de um bloco, para "aparecer quando a palavra em t é dita".
  • CutVideo alterna zoom 1.0 / 1.14 por segmento (zoom em cada corte). Não adicione mais zoom.

Mapa da biblioteca

ArquivoExportaçõesUso para
theme.tsDISPLAY (Anton), SANS (Inter), MONO, cores C, extrude()Todo texto e cor. Sem novas fontes ou cores.
sfx.tsxSFX, SfxEfeitos sonoros (veja acima)
ui.tsxPop, useIn, useOut, BELOW_NECK, Panel, TermFrame, TerminalEfeito de pop com mola, painel da metade inferior, terminal digitado
scenes/Intro.tsxHook({title, sub, subAt}), DailyStep({children}), DayTitle({day}), CommandList({commands, line, lineAt}), LightLeakAbertura, transições de seção
scenes/Commands.tsxCommandTag({n, total, name, nameAt, meaning, meaningAt, color}), FolderPath, FileGrid, MoveSwap, NoteCardUm tópico por seção: tag no topo, visual no Panel
scenes/Commands.tsx (Day 2, texto codificado)IdCard, OwnerSwap, PhoneApps, Snapshot, TopView, PdfSearchAdicione props para o texto antes de reutilizar um
scenes/Outro.tsxDayDone({day}), NextDay({day, commands, at}), FollowCard({handle})Finalização (NextDay é opcional)
Reel.tsxReelReel completo do Day 1. Use como exemplo para estrutura.

Mantenha tamanhos, cores e animação ao alterar o texto.

Habilidades Relacionadas