alyshadotmd/edicao-de-b-roll

Processamento de b-roll

O objetivo: cada vídeo de b-roll é assistido uma vez, os melhores momentos são escolhidos e apenas esses clipes são mantidos. Cada clipe mantido é cortado com um buffer de 1 segundo e marcado conforme o conteúdo, para que qualquer cena possa ser encontrada depois sem precisar reassistir o material.

Esta skill é construída para Claude Code e Runneth. Ela precisa de três coisas:

• Um jeito de ver o vídeo: no Runneth, um modelo de vídeo o assiste. O Claude não consegue assistir vídeo, então ele lê frames estáticos: pequenas folhas de contato com 2 frames por segundo para encontrar momentos (ffmpeg -i IN.mp4 -vf fps=2,scale=160:-2,tile=10x6 sheet_%02d.jpg), frames em tamanho real para julgá-los (ffmpeg -ss <time> -i IN.mov -frames:v 1 frame.jpg), além da transcrição do áudio quando disponível. Se não houver como transcrever, trabalhe apenas com os frames.
• Um jeito de cortar vídeo: ffmpeg, ou qualquer editor de vídeo.
• Uma pasta de biblioteca de b-roll: um lugar para os clipes mais dois tipos de arquivos de texto (um índice e um arquivo por gravação). Os templates estão na pasta templates/ ao lado deste arquivo.

Converse com o editor em linguagem simples do dia a dia, uma ideia de cada vez.

Antes de começar: as ferramentas

No Runneth, tudo já está instalado: pule esta seção.

No Claude Code, esta skill precisa das ferramentas de vídeo gratuitas que a skill video-editing-setup instala. Verifique silenciosamente se ~/.video-editing-tools/bin/ffmpeg -version funciona. Se funcionar, use as ferramentas em ~/.video-editing-tools/bin (ffmpeg, ffprobe, python) onde esta skill disser ffmpeg, ffprobe ou python3, e continue. Se não funcionar, siga primeiro a skill video-editing-setup e depois volte aqui.

Passo 0: Faça uma pergunta primeiro

Antes de fazer qualquer outra coisa, pergunte exatamente isto ao editor, como uma única pergunta com duas opções:

"Você quer que eu apresente os timestamps primeiro, ou quer que eu já comece a trabalhar?"

• Apresente primeiro → siga todos os passos abaixo, incluindo o Passo 3 (o editor escolhe).
• Já comece a trabalhar → execute todos os passos do início ao fim sem parar. No Passo 3, escolha os momentos você mesmo usando "O que torna um momento digno de ser mantido". Não peça aprovação, nomes de projetos ou qualquer outra coisa no caminho; deixe valores desconhecidos como _não informado_ no arquivo da gravação e mencione-os uma vez no final.

Pule a pergunta se o editor já disse qual opção na mensagem ("apenas faça", "não me pergunte", "apresente os picks"). Se não houver ninguém para responder, trate como "já comece a trabalhar".

Passo 1: Mantenha o vídeo completo até que os cortes sejam feitos

1. Salve cada vídeo de b-roll intacto e com duração total, com um nome simples: broll-<n>-<o-que-é>.<ext> (por exemplo broll-4-unboxing.mov). Anote a qual projeto e marca ele pertence, e a data da gravação.
2. Verifique sua duração e orientação.
3. Faça uma cópia de trabalho leve para assistir e escolher. Com ffmpeg: ffmpeg -i IN.mov -vf scale=540:960 -c:v libx264 -preset veryfast -crf 25 -g 15 -pix_fmt yuv420p -c:a aac -b:a 96k -movflags +faststart OUT.mp4 (a pequena distância entre keyframes permite uma navegação suave; troque 540:960 por 960:540 em material landscape).

Passo 2: Marque-o

1. Assista a cópia de trabalho e escreva um mapa de trabalho que cubra cada trecho do vídeo, sem lacunas: intervalo de tempo, tags da lista de tags da biblioteca e uma frase simples do que acontece. Trechos inutilizáveis também ficam no mapa, com uma breve nota sobre o motivo (fora de foco, verificando o quadro), para que fique claro que foram analisados. O mapa é apenas para encontrar os cortes; ele é deletado junto com as cópias de trabalho, e apenas os clipes mantidos recebem tags salvas.
2. Verifique o que um visualizador de IA não pode saber: de quem é o material, se o produto na tela é realmente o produto da marca (um café na cena é apenas café), e qualquer coisa que pareça estranha. Use as pequenas folhas de contato para encontrar momentos, depois olhe os frames em tamanho real antes de considerar qualquer momento utilizável. Frames pequenos escondem um produto suave e para onde os olhos do criador estão olhando.
3. Uma ótima ideia que se mostrou inutilizável se torna uma nota de regravação.
4. Escreva uma linha simples nomeando o ponto de cada vídeo (para o que foi filmado mostrar), deduzido apenas do material. O Passo 3 sempre mantém o momento que o mostra, se for utilizável.
5. Diga se cada vídeo é lifestyle (sem produto nele, reutilizável para qualquer marca) ou produto.

Passo 3: Escolha os momentos

Se o editor quiser uma apresentação primeiro:

1. Dê ao editor as cópias de trabalho e uma pequena lista dos momentos mais fortes do seu mapa de trabalho como ponto de partida.
2. O editor marca cada momento que quer manter: horário de início, horário de fim e por que o escolheu. Qualquer formato funciona (um app de seleção, uma planilha, um documento de notas, timestamps em uma mensagem), desde que cada escolha tenha um início, um fim e um motivo.
3. Os motivos são tão importantes quanto os horários. É assim que esta skill aprende o gosto do editor (Passo 4, item 6).

Se o editor disse para já começar a trabalhar:

1. Escolha os momentos você mesmo, usando "O que torna um momento digno de ser mantido" em ordem. Sempre mantenha o ponto do vídeo (regra 4) e guarde os takes evergreen (regra 9).
2. Quando a mesma ação acontecer mais de uma vez, mantenha o take mais limpo.
3. Escreva um início, um fim e um motivo de uma linha para cada escolha.
4. Verifique cada escolha em frames em tamanho real antes de cortar, pelo menos a cada meio segundo do início ao fim (não apenas no meio): o produto está nítido, os olhos passam na regra 3 em todos os frames, e os horários estão corretos (horários de IA são aproximados, não exatos). Descarte qualquer escolha que falhar, ou ajuste-a para o trecho que passa.
5. Antes de salvar, compare as escolhas de cada vídeo lado a lado. Quando duas escolhas mostrarem quase o mesmo take (mesmo enquadramento, mesmo assunto), mantenha apenas aquele com mais ação e descarte o outro (regra 11).

Passo 4: Corte as escolhas e salve-as

1. Corte cada escolha na qualidade total a partir do arquivo original, com 1 segundo de material extra antes e depois dos horários do take, limitado ao início e fim do vídeo. Nomeie cada clipe <data-da-gravacao>-v<video>-<take>-<oque-acontece>.mp4 (por exemplo 2026-10-22-v4-4-unbox-tear-top.mp4). A data evita conflitos de nomes, já que todas as gravações de uma marca caem na mesma pasta e os números de vídeo reiniciam a cada gravação. Com ffmpeg, um corte de alta qualidade é -c:v libx264 -crf 16. Se um clipe for muito grande para mover para onde precisa ir, aumente um pouco o crf (18) em vez de encurtá-lo.
2. Uma escolha sem duração (início igual a fim) é uma nota, não um clipe. Ela vai no arquivo da gravação nas notas de regravação (por exemplo "fora de foco, regravar").
3. Armazene os clipes na pasta de b-roll da marca, o único lugar onde todo o b-roll daquela marca fica entre projetos.
4. Escreva o arquivo da gravação, um por gravação, em shoots/<data-da-gravacao>-<marca>.md na pasta da biblioteca (template: templates/shoot-file.md): o ponto de cada vídeo, depois cada clipe mantido com seu nome de arquivo, horário do take, tags, o que acontece e por que foi escolhido. Os motivos do editor vão palavra por palavra; motivos que a IA escreveu são marcados como "(IA)". Termine com notas de regravação e os takes que ainda faltam para esta marca.
5. Adicione cada clipe sob suas tags na tabela "Encontrar por tag" do índice da biblioteca. Na primeira vez, inicie o índice a partir de templates/b-roll-library-index.md. Depois, delete os vídeos completos originais e todas as cópias de trabalho. Apenas os clipes escolhidos são mantidos.
6. Aprenda com os motivos: transforme cada um dos motivos do editor em uma regra geral e mescle-a em "O que torna um momento digno de ser mantido" abaixo (ou na skill de seleção de b-roll quando for sobre onde um clipe vai em um vídeo). Mantenha a lista curta: reescreva e combine regras em vez de acumular novas. Apenas os motivos do editor mudam as regras; motivos marcados como "(IA)" permanecem como estão.
7. Se o editor rejeitar um clipe mantido depois, delete-o, remova-o do arquivo da gravação e do índice, e transforme o motivo em uma regra.

Encontrando b-roll depois

Quando alguém pedir um tipo de take ("unboxing para esta marca", "eu parecendo cansado"), procure na tabela "Encontrar por tag" do índice da biblioteca e devolva os clipes correspondentes. Uma tag simples (pet) corresponde a todos os detalhes abaixo dela (pet:gato, pet:cachorro). Clipes lifestyle contam para qualquer marca; clipes de produto pertencem à sua própria marca.

O que torna um momento digno de ser mantido

Estas regras vieram das escolhas e motivos de um editor real em uma gravação de produto UGC. Aplique-as em ordem, depois substitua-as pelas regras do seu próprio editor conforme os motivos deles chegarem.

1. Movimento. O melhor momento em um take é onde algo muda: uma virada de cabeça, um gesto com a mão, uma nova expressão, um animal de estimação entrando. Um take onde nada se move parece uma foto. Um take parado só é mantido como um acento curto (um close-up limpo do produto); marque-o como static.
2. Um rosto que expressa o sentimento. Um suspiro, um bocejo, mãos na cabeça, um grande sorriso. A expressão mostra o sentimento da linha por si só.
3. Olhos com intenção. Olhar para a câmera só conta quando é de propósito: uma selfie, falando ou reagindo ao espectador, ou mostrando o produto para a lente. Caso contrário, os olhos pertencem ao assunto do take (a bebida, o laptop, o pacote). Um criador que olha para a lente enquanto apenas senta, ou desvia o olhar para o lado, está se verificando no quadro (geralmente em uma tela de celular colocada de lado), e esse trecho não é o take. O take real é o trecho onde ele não está se verificando: o bocejo, a mexida, o suspiro. Comece após qualquer verificação e termine antes da próxima; um trecho onde ele verifica o quadro mais de uma vez é pulado.
4. O ponto do vídeo é sempre escolhido. Cada vídeo de b-roll foi filmado para mostrar algo, e o momento que mostra isso mais claramente é sempre um keeper. Leia o ponto do próprio material: no que a maior parte do vídeo é gasta, ou o que o criador prepara e depois mostra. O ponto pode ser qualquer coisa: um produto derramando suavemente, o pó de um concorrente empelotando, um "antes" bagunçado, um animal de estimação fazendo algo engraçado. Mostrar o produto funcionando é um tipo de ponto, não a regra. Se o momento que mostra o ponto não for utilizável (borrado, fora do quadro), ele se torna a primeira nota de regravação.
5. Vida real no quadro. Animais de estimação, pequenos momentos engraçados (jogar um pacote vazio) e outros detalhes não planejados fazem o b-roll parecer real e dão aos espectadores algo para olhar.
6. A versão natural e lisonjeira. Quando o criador faz a mesma ação duas vezes, a que parece natural e como uma pessoa real vence (um bocejo com a mão na boca).
7. Foco nítido. Um take conta quando o produto e o rosto estão em foco. Julgue o foco em um frame em tamanho real, nunca em uma folha de contato. Se o produto nunca estiver nítido em nenhum lugar do take, o take inteiro está descartado. Uma ótima ideia que ficou borrada se torna uma nota de regravação.
8. O produto completo. Mostre o pacote inteiro e vire-o para mostrar o verso. Virá-lo adiciona movimento e apresenta o produto, e o verso carrega detalhes como ingredientes.
9. Takes Evergreen, sempre. Guarde estes de cada gravação de produto, mesmo que o vídeo atual não os use: unboxing (rasgar, olhar dentro, puxar um), produto em uso (abrir, derramar, misturar, beber), apontar para os ingredientes, criador sorrindo com o produto, close-up limpo do produto, segurando o produto. Qualquer close-up bom também vale a pena guardar (um copo levantado para a lente, mãos misturando); marque-o como closeup:<oque> para que possa ser usado como um acento curto.
10. Curto é suficiente. Uma fatia limpa de 2 segundos é um clipe utilizável.
11. Uma versão de cada take. Quando dois momentos parecem quase iguais (o mesmo copo segurado perto da lente), guarde apenas aquele onde algo está acontecendo (mexendo-o). A versão parada nunca é salva junto.
12. Corte para a ação principal. Cada vídeo de b-roll tem um movimento principal para o qual foi filmado (puxar o cobertor para cima dela, o derramamento, o bocejo). O take segura esse movimento com apenas uma batida antes. Preparação e agitação (ajustar o cobertor, reorganizar o travesseiro, preparar o pacote) ficam de fora, mesmo quando estão no mesmo trecho.

Regras para cada tag

• Cada clipe mantido tem um início, um fim, tags, uma descrição simples e um motivo.
• Tags descrevem apenas o que pode ser visto no clipe, para que qualquer pessoa marcando o mesmo clipe escolha as mesmas tags sem conhecer a marca ou o roteiro. O que um clipe significa para um vídeo (um take "antes", um ponto de dor) é decidido depois, na skill de seleção de b-roll.
• Adicione o detalhe após os dois pontos (tag:<oque>) sempre que for visível e alguém possa pesquisar por ele.
• Os horários vêm da linha do tempo do arquivo original. O arquivo da gravação registra os horários dos takes; o clipe em si começa 1 segundo antes.
• Horários gerados por IA são aproximados, não exatos. Verifique-os em frames em tamanho real antes de cortar.