Communitygithub.com

jhatpat-reel

Transforme uma longa gravação de talking head em um Instagram Reel ou YouTube Short compacto. Corta silêncios e pausas, mantém a melhor versão de cada fala, reenquadra para 9:16 / 1:1 / 16:9, insere legendas no estilo Instagram e exporta uma EDL para o Premiere Pro. Feito para criadores de conteúdo em Hinglish e Hindi que gravam uma única tomada com celular ou DSLR.

O que é jhatpat-reel?

A skill 'jhatpat-reel' é um editor de primeiro rascunho (first-pass editor), não um editor final. Ela automatiza a edição inicial de vídeos de uma única pessoa falando (talking head), cortando silêncios e pausas mortas, e gerando versões otimizadas para plataformas como Instagram Reels e YouTube Shorts. A skill é compatível com ffmpeg, ffprobe e Python 3.9+, e funciona com transcrições opcionais geradas por STT como Whisper. Caso uma transcrição seja fornecida, a skill também identifica e remove retakes e hesitações (como 'hmm', 'sorry'), mantendo apenas a melhor versão de cada frase. O pipeline é dividido em cinco estágios: inspeção e preparação da mídia, corte bruto com presets ajustáveis (reel, calm, tight), verificação auditiva dos cortes, reenquadramento para diferentes proporções e queima de legendas com estilos variados (pop, box, bar). A skill também exporta uma EDL para Premiere Pro, permitindo refinamentos manuais. É ideal para criadores Hinglish, Hindi ou Inglês que desejam acelerar o processo de edição sem comprometer o material original (raw footage nunca é alterado).

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ankurrattan0110-spec/jhatpat-reel/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

O que jhatpat-reel faz?

Fala direta: você dá uma longa tomada, recebe um reel enxuto de volta. O primeiro esboço a máquina faz, o toque final é seu.

Esta skill é primeiro rascunho, não editor final. Ela remove silêncios e pausas mortas; retakes e gaguejos você (ou o Claude lendo a transcrição) indica. O material original nunca é alterado.

Quando usar

  • Um único falante, uma única tomada, de celular ou DSLR — talking head.
  • Instagram Reel, YouTube Short, ou ambos a partir da mesma tomada.
  • Hinglish, Hindi ou Inglês — os três funcionam.

Quando não usar: entrevista multicâmera, videoclipe, ou edição onde cada corte exija critério artístico. Para isso, abra a timeline você mesmo.

Pré-requisitos

ItemPor quêVerifique com
ffmpeg + ffprobeCortar, reenquadrar, legendasffmpeg -version
python3 3.9+Executar os scriptspython3 --version
transcrição (opcional)Detectar retakeswhisper / whisperx / qualquer STT
fonte Devanagari (opcional)Legendas em HindiNoto Sans Devanagari

Pipeline

A saída de cada etapa é a entrada da próxima. Pare no meio para conferir, depois siga em frente.

Etapa 0 — inspecione, depois corte

Faça a inspeção da mídia. Informe ao criador em uma linha: duração, resolução, taxa de quadros, em qual canal está o áudio. Se já for vertical, o reenquadramento pode ser pulado. Se o áudio está em apenas um canal (problema comum com microfone sem fio), corrija isso primeiro — caso contrário, após o corte metade do reel ficará sem som.

Se conseguir obter uma transcrição, pegue-a agora. Sem transcrição, esta skill só consegue remover silêncios; não consegue detectar retakes nem gaguejos. Deixe isso claro para o criador.

Etapa 1 — corte bruto

python3 scripts/rough_cut.py take.mp4 --preset reel

Presets: reel (padrão, enxuto), calm (poesia, história, fala longa), tight (gancho pesado, rápido).

Isso gera três arquivos: cuts.json, <nome>_cut.mp4, <nome>.edl.

Se houver transcrição, leia o cuts.json e remova os trechos com retakes: se a mesma frase foi dita duas ou três vezes, mantenha a última clara, remova as demais. "desculpa", "de novo", "hmm" — também são removidos. Em seguida, renderize novamente. Não edite o cuts.json manualmente — altere o preset ou a configuração e execute o script novamente.

Etapa 2 — ouça o corte e verifique

É essencial ouvir 0,2s de cada lado de cada corte. Se alguma palavra foi cortada ao meio, aumente --pre-pad / --post-pad. A transcrição pode parecer correta enquanto o áudio está cortado.

Etapa 3 — reenquadramento

python3 scripts/reframe.py take_cut.mp4 --all        # 9:16 + 1:1 + 16:9
python3 scripts/reframe.py take_cut.mp4 --to 9:16 --anchor 0.3

--anchor define de onde o quadro será cortado. Em talking head o rosto fica em cima, portanto o padrão é 0.35. Se o rosto estiver sendo cortado, diminua o anchor. Para gravação de tela, use --mode pad — o crop cortaria textos.

Etapa 4 — legendas

python3 scripts/burn_captions.py take_cut_9x16.mp4 take.srt --style pop --accent "#C6FF3D"

Estilos: pop (1–3 palavras grandes no centro — para reel e gancho), box (caixa sólida, legível mesmo sobre cenas movimentadas), bar (linha fina na parte inferior, para formato longo).

O script divide automaticamente legendas longas em trechos menores, para que o estilo pop faça sentido. Para legendas em Hindi, forneça o caminho de uma fonte Devanagari com --font — senão os caracteres não serão renderizados corretamente.

Etapa 5 — verificação final

Antes da exportação, execute esta verificação no seu próprio trabalho:

  1. Primeiro segundo. No primeiro quadro deve haver algo — rosto, palavra grande ou movimento. Quadro vazio = scroll.
  2. Nenhuma palavra cortada. Ouça três cortes aleatórios.
  3. Legendas não cobrem o rosto. Em 9:16, pop fica no centro; se o rosto estiver no centro, --style box é melhor.
  4. Últimos 2 segundos. A CTA deve aparecer e permanecer, não sair correndo.
  5. Áudio. Instagram e YouTube normalizam para -14 LUFS. Se você deixar mais baixo, eles aumentarão e a qualidade piorará:
    ffmpeg -i final.mp4 -af loudnorm=I=-14:TP=-1.5:LRA=11 -c:v copy out.mp4
    

Regras (cada regra com sua razão)

  • Nunca toque no material original. Tudo em novo arquivo. Porque um único erro de renderização não recupera a gravação.
  • Não aplique zoom nos cortes. Porque zoom no corte anuncia o corte.
  • Um reel, uma ideia. Outra ideia é outro reel. Porque duas ideias juntas = nenhuma é lembrada.
  • Não remova todas as pausas. Não reduza pause_keep abaixo de 0,2s. Porque palavras totalmente coladas soam robóticas, e é preciso espaço para respirar.
  • Nada antes do gancho. Se os primeiros 3 segundos não estiverem bons, o resto da edição é inútil. Porque é ali que as pessoas decidem rolar ou parar.
  • O que o criador removeu manualmente, não traga de volta. Antes de renderizar novamente, leia a versão deles.
  • Não afirme que removeu retakes sem transcrição. Seja claro: "silêncios removidos, retakes você precisa verificar."

Configuração

Copie config.example.json para config.json, depois use --config config.json. O significado de cada valor está descrito no próprio arquivo.

O que esta skill não faz

  • Não filma. A gravação é sua.
  • Não posta no Instagram.
  • Não baixa nem copia vídeos de outras pessoas.
  • Não escolhe música — a licença é sua responsabilidade.
  • Não gera transcrição; execute o STT você mesmo e forneça o arquivo SRT.

Incorpore feedback à skill

Quando o criador disser "o corte está muito abrupto" ou "a legenda está cobrindo o rosto" — corrija e escreva essa observação aqui como regra, com a justificativa. Depois de alguns reels, esta skill passará a funcionar de acordo com seu gosto.

Habilidades Relacionadas