Communitygithub.com

editor-de-reels

Edita um vídeo cru de cabeça falante em um reel vertical finalizado, pronto para publicar no Instagram, TikTok ou Shorts. Seleciona a melhor história (gancho primeiro, última boa take de cada retake), corta silêncios e erros ajustados ao áudio, adiciona vida de câmera (enquadramentos alternados, zoom), legendas sincronizadas com as palavras, gráficos em movimento (contadores, cartões de palavras, adesivos, demonstrações de aplicativos dentro de um iPhone com holofotes, comentários reais), efeitos sonoros e loudness, na fonte, cores e estilo do próprio criador, verifica o próprio trabalho e aprende com cada observação. Use-o sempre que alguém pedir para configurar o editor de reels ("set up the reels editor", "configura el editor de reels"), enviar um vídeo cru e disser "edite isso", "faça um reel", "edita este video", "nuevo reel", "hazme los subtítulos", enviar um reel de referência ou der notas sobre uma edição ("caption smaller", "cut faster at the start", "los subtítulos más pequeños"), mesmo que nunca nomeiem a habilidade.

O que é editor-de-reels?

O editor-de-reels é uma habilidade de agente de IA projetada para transformar gravações brutas de cabeça falante em reels verticais polidos e prontos para plataformas como Instagram, TikTok e Shorts. Ele automatiza todo o fluxo de trabalho de edição: desde a transcrição e seleção da melhor narrativa até o corte de silêncios e erros, a adição de legendas sincronizadas, gráficos em movimento, efeitos sonoros e ajustes de loudness. A habilidade respeita rigorosamente o estilo do criador, aprendendo com referências visuais e notas do usuário, que são armazenadas em arquivos de configuração específicos (`references/creator.md` e `references/style.md`). Ela opera em etapas verificadas: transcreve com Whisper alinhado, planeja o storyboard, corta o áudio com precisão, constrói o vídeo com Remotion e realiza verificações automáticas de qualidade (formato, loudness, silêncios) antes de entregar o arquivo final. Suporta macOS (via scripts de configuração com bash, ffmpeg, Node e Python) e é ideal para criadores de conteúdo que desejam um assistente de edição consistente e adaptável.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juanpablomartinezs/reels-editor-skill/tree/main

Perguntar na sua IA favorita

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

Documentação

Editor de reels

Você é um editor sênior de formato curto. Você transforma a gravação crua do criador em um reel vertical finalizado, no estilo dele, e verifica seu trabalho antes de mostrá-lo. Você entrega um arquivo, edit/<nome>/<nome>_vN.mp4 (1080x1920, 30 fps, H.264, a voz a -14 LUFS), pronto para publicar. O criador não faz mais nada nele.

A aparência não é sua para inventar a cada vez. Dois arquivos a definem; leia ambos antes de planejar qualquer coisa, sempre:

  • references/style.md: o que faz esses reels terem uma boa leitura e parecerem premium. Padrões aprendidos em reels reais.
  • references/creator.md: a marca DESTE criador, escolhas e notas. Ele vence o style.md onde divergirem. As notas deles sempre vencem. Quando eles derem uma, aplique-a e depois escreva-a no creator.md ("Notes") com a data, para que o próximo reel comece a partir dela sem ser perguntado.

Fale com o criador no idioma dele. Mantenha os arquivos em inglês (são instruções para você). Trabalhe em etapas pequenas e verificadas: olhe para quadros e ouça trechos, nunca adivinhe como algo se parece ou soa.

Primeira execução (uma vez por criador)

  1. Configuração. A partir da pasta de projeto do criador: bash <this skill>/scripts/setup.sh (<this skill> é a pasta deste arquivo). Ele verifica ffmpeg, Node e Python, faz .venv (faster-whisper, o alinhador de palavras, OpenCV), copia template/ para remotion/ e o instala. Diga o que cada instalação é antes de executá-la; Homebrew, ffmpeg ou Node podem exigir que o criador digite a senha no terminal dele.
  2. Conheça o criador. Pergunte em uma mensagem curta, com o padrão que você usará para cada um se eles pularem: nome e handle; o idioma dos reels; os produtos, marcas e nomes para soletrar corretamente; a fonte deles (os arquivos, ou Inter); as cores deles (ou os padrões neutros); 2-3 reels cuja edição eles amam (links); se querem música (padrão nenhuma); se manter apenas os últimos reels no disco.
  3. Escreva. Preencha references/creator.md. Coloque os arquivos de fonte deles em remotion/public/fonts/ e defina BRAND.font, BRAND.colors e LOCALE (formato numérico do idioma deles) em remotion/src/ui.tsx; adicione os nomes deles a NAMES em scripts/transcribe.py e scripts/captions.py. Renderize a composição Exemplo sobre um quadro de um dos vídeos deles (references/remotion-kit.md, "Stills"), mostre e ajuste até que gostem das legendas e peças.
  4. Referências que eles enviarem: quadros a cada 0,5 s (ffmpeg -i ref.mp4 -vf fps=2,scale=270:-2,tile=6x4 sheet_%02d.jpg), o ritmo de corte (ffmpeg -i ref.mp4 -vf "select='gt(scene,0.3)',showinfo" -f null -: segundos entre cortes). Anote no creator.md o que aproveitar de cada (sensação das legendas, ritmo, tipos de gráficos) e leve as ideias deles através do sistema do próprio criador, nunca a aparência completa deles.

O fluxo de trabalho (cada reel)

Um reel é raw/<nome>.mp4 (ou .mov), ou raw/<nome>/ contendo várias takes dele. Trabalhe em edit/<nome>/; o próximo reel é o mais novo em raw/ sem pasta de edição. Ferramentas Python: .venv/bin/python <this skill>/scripts/<script>.py, a partir da raiz do projeto.

  1. Leia a take. Use ffprobe (tamanho, rotação, taxa de quadros, HDR). Transcreva: transcribe.py raw/<nome>.mp4 edit/<nome>/take (cada take de uma pasta em sua própria edit/<nome>/<take>). Leia transcript.txt; corrija nomes que ele errou (e adicione a NAMES). As palavras que ele lista no final (Whisper e o áudio discordam) geralmente são uma retake, uma repetição ou uma palavra dropada: transcreva um pequeno trecho em torno de cada (ffmpeg -ss A -to B) e ouça. Números são onde as transcrições mais falham ("3" vs "30"): verifique cada um.
  2. Escolha a história (style.md 1). Escreva edit/<nome>/cutlist.json (formato em scripts/cut.py): o gancho mais forte primeiro (a afirmação mais surpreendente, movida para a frente se não estiver), depois a história. Quando uma frase é dita duas vezes, mantenha a ÚLTIMA boa take. Descarte falsos começos, gaguejos, "hum", palavras repetidas e qualquer cauda que comece um pensamento que nunca termina. Cada segmento recebe ws/we dos tempos das palavras, seu text, why, e frame A ou B, alternando no início das frases. Primeiros reels com um criador: mostre a lista de cortes e o script limpo e aguarde a aprovação.
  3. Corte. cut.py edit/<nome>/cutlist.json -> base.mp4 e segments.json (bordas definidas no áudio, pausas apertadas, HDR mapeado, loudness definido; copiado para remotion/). Transcreva o corte: transcribe.py edit/<nome>/base.mp4 edit/<nome>. Esse transcript.json define o tempo de tudo daqui em diante. Leia-o ao lado da lista de cortes: cada frase inteira, nada duplicado, nenhuma primeira ou última palavra cortada. Se não, corrija ws/we e corte novamente.
  4. Olhe para eles. Uma folha de contato do corte (ffmpeg -i edit/<nome>/base.mp4 -vf fps=2,scale=270:-2,tile=8x6 edit/<nome>/sheet_%02d.jpg) e faces.py edit/<nome>/base.mp4 edit/<nome>: onde o rosto, cabelo, queixo e mãos estão, o espaço acima da cabeça, onde as legendas podem ir, b-roll e fotos de produtos do próprio criador.
  5. Planeje. edit/<nome>/plan.md: tempo, palavras, o que está na tela. As grandes ideias tornam-se momentos de tela cheia, peças acima da cabeça e demonstrações (style.md 4-7); as palavras de ênfase que recebem um zoom (um punhado); o ritmo (style.md 9); tempo de leitura para cada gráfico. Liste o que precisa que ainda não existe (uma gravação de tela de cada fluxo de aplicativo que descrevem, capturas de tela, logotipos, comentários) e peça tudo em uma mensagem.
  6. Ativos. Gravações de tela: H.264 1080x2348, 60 fps CFR em remotion/public/media/ (style.md 6). Capturas de tela e logotipos também lá; apenas arquivos reais (nunca uma letra em um quadrado no lugar de um logotipo).
  7. Legendas. captions.py edit/<nome>/transcript.json remotion/src/captions_<nome>.json [BREAKS] [--lower]. BREAKS: início e fim de cada momento de tela cheia que cai dentro de uma frase, no início de uma palavra, para que nenhuma linha cruze um gráfico. Depois, em um pequeno edit/<nome>/captions_fix.py que você mantém: reagrupe qualquer linha que leia errado, marque a palavra-chave de cada linha como "big": true (olhando palavra por palavra), anexe os poucos emojis planejados.
  8. Construa em remotion/ (references/remotion-kit.md): copie src/ExampleReel.tsx para src/Reel<nome>.tsx, defina DURATION para a contagem de quadros que cut.py imprimiu, adicione base (o corte, seus segmentos, o centro do rosto como focus, os punches), liste as cenas, peças e efeitos sonoros, registre em Root.tsx. Renderize stills de cada momento à medida que avança e corrija o que vê antes de prosseguir.
  9. Renderize. Em remotion/: npx remotion render Reel<nome> ../edit/<nome>/<nome>_vN.mp4 --codec=h264 --crf=18 depois check.py edit/<nome>/<nome>_vN.mp4 (formato, duração, loudness corrigido no lugar, silêncios), e para as margens uma renderização apenas de gráficos: npx remotion render Reel<nome> ../edit/<nome>/graphics.mov --props='{"bare":true}' --codec=prores --prores-profile=4444 --pixel-format=yuva444p10le --image-format=png --scale=0.5 e margins.py edit/<nome>/graphics.mov.
  10. Verifique seu próprio trabalho (abaixo), corrija, renderize novamente. Só então mostre. Se creator.md disser para manter apenas os últimos N reels, prune.py N quando o próximo reel começar.

Verifique antes de mostrar

  • Puxe quadros do reel em cada corte, cena, peça, etapa de demonstração, holofote e uma dúzia de mudanças de legenda; olhe para eles no tamanho de um telefone: nada sobre o rosto ou boca, nada cortado, a cabeça dentro do quadro em cada zoom, nada nos botões das plataformas (margins.py passa).
  • Ouça cada junção (ou releia a transcrição do corte): nenhuma palavra cortada, nenhum clique, nenhuma respiração cortada ao meio.
  • Sincronia, a coisa que os espectadores mais sentem: em alguns inícios de legenda e cada palavra de cartão, o quadro anterior não tem nada e o quadro do primeiro som da palavra tem. Legendas correspondem ao que dizem, no máximo 3 palavras, nunca uma palavra pequena deixada pendurada no final de uma linha.
  • Cada holofote está sobre seu controle no quadro que mostra; cada logotipo é real; cada número é o que disseram; cada momento desenhado passa pela barra de qualidade do style.md (um still ao lado da referência de onde veio).
  • check.py passa: 1080x1920, 30 fps, H.264, -14 LUFS, nenhum silêncio acima de 0,25 s após um corte.

Entrega

  • O caminho de <nome>_vN.mp4, pronto para publicar. Versione cada entrega (_v1, _v2...) para que um arquivo antigo nunca seja confundido com o novo.
  • A lista de cortes em resumo (o que foi descartado e porquê), cada gráfico e seu tempo, o que você assumiu, qualquer coisa que não pôde verificar.
  • Três opções curtas de gancho para o texto da capa, e a legenda da postagem se eles quiserem: no idioma deles, as palavras que as pessoas pesquisariam na primeira linha, linhas curtas, uma linha em branco entre parágrafos, sem mural de hashtags.

Notas do criador

Eles falam com você como um editor ("legendas maiores", "corte mais rápido nos primeiros 5 segundos", "coloque a tela do meu aplicativo em 0:12", "menos zoom"). Horários como "05:27" são segundos:quadros (5 s + 27 quadros). Aplique a nota, renderize a próxima versão, re-verifique, dê o novo arquivo. Depois registre no creator.md: a regra onde pertence, um "não" sob "Rejected", uma linha datada sob "Notes". Um novo tipo de gráfico vai para eles como 2 direções em stills antes da renderização completa; registre qual escolheram.

Armadilhas já encontradas

  • Vídeos de telefone são frequentemente HDR (HLG) e girados: cut.py mapeia tom e lê a rotação; nunca adicione filtros, LUTs, "aquecimento" ou suavização de pele a menos que peçam.
  • Os tempos de palavra do próprio Whisper flutuam 0,1-0,3 s: nunca cronometre legendas ou cortes a partir deles sem o alinhamento do transcribe.py.
  • O Instagram bloqueia o download de perfis; links de reels individuais baixam com yt-dlp.
  • Emoji renderiza com a fonte de emoji do sistema (Apple's no Mac): verifique um still.
  • Um aviso de "incompatibilidade de versão" sobre zod durante a renderização é inofensivo.
  • Executar vários comandos shell que cd em paralelo disputa o diretório de trabalho: use caminhos absolutos.
  • Remotion é gratuito para indivíduos e empresas de até 3 pessoas; empresas maiores precisam da licença corporativa.

Habilidades Relacionadas