alyshadotmd/video-editing

Legendas

O objetivo: legendas que o espectador lê sem esforço. Cada uma é um pequeno trecho completo de sentido, com o tempo exato da palavra, posicionado no mesmo local durante todo o vídeo.

Esta é a etapa 5 da ordem de edição: corte do a-roll, b-roll, enquadramento, título, legendas. Executa-se sobre o vídeo enquadrado e com título, para que as legendas não interfiram com o título.

Este skill foi desenvolvido para Claude Code e Runneth.

Antes de começar: as ferramentas

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

No Claude Code, este skill precisa das ferramentas gratuitas de vídeo instaladas pelo skill video-editing-setup. Verifique silenciosamente se ~/.video-editing-tools/bin/ffmpeg -version funciona. Se funcionar, use as ferramentas em ~/.video-editing-tools/bin (ffmpeg, ffprobe, python) onde este skill mencionar ffmpeg, ffprobe ou python3, e continue. Caso contrário, siga primeiro o skill video-editing-setup, depois volte aqui.

A fonte: Figtree Bold, a única fonte usada por este skill. É uma fonte gratuita do Google Fonts. Verifique silenciosamente se ela está no computador ou em uma pasta de fontes ao lado do projeto. Se não estiver, pergunte: "Este skill usa Figtree, uma fonte gratuita do Google. Quer que eu baixe para você?" Em caso positivo, baixe o arquivo Figtree Bold do Google Fonts (fonts.google.com/specimen/Figtree) em uma pasta de fontes ao lado do projeto e continue. Essa verificação também se aplica no Runneth.

O que é necessário

• O vídeo, enquadrado e com o título (ou seu timing).
• O roteiro, se houver, para que nomes e nomes de produtos sejam escritos corretamente.
• Quando o título aparece na tela e onde ele está posicionado.

Passo 0: Pergunte sobre o estilo primeiro

Pergunte um de cada vez, aguardando cada resposta:

1. "Você quer legendas uma palavra por vez ou algumas palavras por vez?"
2. Apenas para algumas palavras por vez: "Você quer que a palavra sendo dita fique destacada em uma cor diferente?"
3. Apenas se sim: "Qual cor?" Ofereça amarelo brilhante (#FFFF3A) como padrão, ou a cor da marca.

Passo 1: Obtenha cada palavra com seu tempo

1. Transcreva o som do próprio vídeo com timings de palavra (faster-whisper base, word_timestamps=True, vad_filter=False). Os timings devem vir deste vídeo exato, porque cada corte os desloca.
2. Use a grafia do roteiro para nomes, marcas e nomes de produtos, e mantenha o timing da transcrição.
3. Cada palavra falada recebe uma legenda. Nada que não foi dito recebe legenda.

Passo 2: Divida em trechos por sentido (apenas para algumas palavras por vez)

1. Geralmente de 1 a 3 palavras por trecho, no máximo cerca de 5 quando isso mantém uma frase inteira e ainda cabe na largura.
2. Mantenha juntos: um substantivo com suas palavras descritivas ("uma bebida do sono"), nomes ("skill Claude"), um verbo com suas palavras auxiliares ("ir para a cama") e pensamentos curtos completos ("mas foi assim que me senti").
3. Cada trecho termina em uma palavra que carrega sentido. Palavras pequenas (o, a, de, para, e, porque, que, eu) começam o próximo trecho.
4. Cada trecho é exibido desde sua primeira palavra até o início do próximo, para que a tela nunca fique vazia no meio de uma frase.
5. Leia a lista inteira uma vez como um espectador e corrija qualquer quebra que soe estranha.

Passo 3: A aparência

Cada legenda usa Figtree Bold, branca, com contorno preto. Sem caixa, sem sombra, sem animação de entrada: as legendas simplesmente aparecem. Principalmente minúsculas, com I, nomes e marcas em maiúsculas, e sem pontos finais ou vírgulas no final.

• Uma palavra por vez: cerca de 140px com contorno de 6px, uma palavra na tela por vez. Cada palavra permanece até a próxima começar. Palavras longas encolhem para caber em cerca de 720px de largura. Pule a divisão em trechos do Passo 2.
• Algumas palavras por vez: cerca de 60px com contorno de 3px, usando os trechos do Passo 2.
  • Com destaque de cor: a palavra sendo dita muda para a cor escolhida dentro do trecho, estilo karaokê.
  • Sem destaque: o trecho inteiro permanece branco.

Passo 4: Onde posicionar

1. Centralizado, na altura do peito, cerca de y 1260 a 1305 em um vídeo 1080x1920: abaixo do queixo, acima da legenda do aplicativo e dos botões.
2. Dentro da área segura: As zonas seguras vêm do skill post-preview: mantenha tudo dentro de x 100 a 880, y 290 a 1340 em um quadro 1080x1920 (a única caixa segura para Reels, Stories, Feed, TikTok e Facebook). Consulte o post-preview para ver áreas cobertas exatas quando algo estiver perto da borda. Legendas centralizadas, portanto, mantêm cada letra (incluindo contorno) dentro de x 200 a 880, que tem cerca de 680px de largura, e acima de y 1340. Meça a largura de cada trecho; um trecho muito largo é dividido.
3. Sem sobrepor o título. Enquanto o título estiver na tela, as legendas ficam abaixo dele com uma folga clara; quando o título estiver baixo, as legendas descem dentro da área segura em vez de se sobreporem a ele.
4. O mesmo local em todo o vídeo, para que o olho sempre saiba onde olhar.
5. As legendas ficam abaixo da boca, nunca sobre o rosto. Cada legenda fica longe dos olhos, nariz e boca. Quando o rosto está tão baixo que o local da legenda o cobriria, o problema é o enquadramento: envie de volta para o enquadramento corrigir (ou mova a legenda para baixo dentro da área segura enquanto isso é corrigido).

Passo 5: Criação e gravação

1. Escreva as legendas como um arquivo de legenda ASS. Com destaque de cor, use um evento por palavra para que a cor acompanhe a fala. O espaçamento entre letras vai em uma tag inline \fsp.
2. Aponte o renderizador para uma pasta de fontes contendo apenas o arquivo Figtree Bold, para que o peso correto seja usado: ass=legendas.ass:fontsdir=fonts.
3. Grave em uma passada a partir do vídeo em qualidade total (x264, slow, crf 14 a 18), som copiado sem alterações.

Passo 6: Verifique antes que alguém veja

1. Cada palavra, uma vez, no tempo certo: compare a lista de legendas com a transcrição, palavra por palavra.
2. Um quadro de cada trecho: dentro da área segura, nada cortado, nada sobrepondo o título, e a legenda inteira abaixo da boca. Use um detector de rosto ou leia cada quadro; uma legenda sobre qualquer parte do rosto falha na verificação.
3. Com destaque de cor, a cor acerta a palavra sendo dita, verifique em alguns pontos ao longo do vídeo.

Passo 7: Aprenda com o editor

Quando o editor alterar uma divisão, uma palavra ou a aparência, pergunte o motivo (a menos que ele tenha explicado). Escreva o motivo como uma regra em "Regras de legendas do editor" abaixo, redigida como o que deve ser verdadeiro. Razões que você mesmo criou são marcadas como "(IA)" e nunca alteram as regras.

Regras de legendas do editor

(Vazio para começar. Adicione cada regra que o editor fornecer.)