Communitygithub.com

humanohibridooficial-sys/montar-reels

Edita reels verticais 9:16 a partir de gravações feitas com o celular (limpar áudio e imagem, transcrever, cortar silêncios e repetições, legendas automáticas, montar no CapCut e revisar volume e zona segura) e aprende o estilo de edição do usuário a partir de seus reels finalizados e de reels de referência (conta fantasma).

O que é montar-reels?

Este skill permite editar reels verticais 9:16 de forma semiautomática, usando gravações brutas do celular. Ele limpa áudio e imagem, transcreve o conteúdo, corta silêncios e repetições, adiciona legendas com destaque para palavras-chave, monta o projeto no CapCut e revisa volume e zona segura. O skill também é capaz de aprender o estilo de edição do usuário analisando seus reels finalizados (através da análise de arquivos `.mp4` e projetos do CapCut) e reels de referência de outras contas (conta fantasma), ajustando parâmetros como duração de cortes, estilo de legendas, cores e volume. Ele se integra com Python, CapCut, Whisper (transcrição) e ferramentas como yt-dlp e Pexels API. O fluxo é interativo: o usuário aprova cada etapa antes de passar para a próxima, e o skill sugere melhorias baseadas na análise de repetições e falhas. É ideal para criadores de conteúdo que querem otimizar o processo de edição mantendo controle criativo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/humanohibridooficial-sys/montar-reels/tree/HEAD/skill

Perguntar na sua IA favorita

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

Documentação

Montar reels

Sistema de edição em {{REPO}}. Todos os comandos são executados a partir de {{REPO}}\scripts com o Python do ambiente: {{REPO}}\.venv\Scripts\python.exe. Os caminhos (trabalho, CapCut, fontes, cores) vêm de {{REPO}}\config.json; não escreva caminhos manualmente nos scripts.

Antes de editar NADA

  1. Leia {{REPO}}\mi-estilo\estilo.md (o que o usuário quer) e, se existirem, mi-estilo\aprendido.md (o que foi aprendido de seus reels) e mi-estilo\referencias.md (o que foi aprendido de sua conta fantasma). Eles têm precedência sobre as regras padrão abaixo. Se houver conflito entre eles, prevalece estilo.md.
  2. Se estilo.md estiver vazio e for a primeira vez, ofereça preenchê-lo com 5-6 perguntas curtas (tema, duração, legendas, cor, música). Não bloqueie: se não quiser, use os valores padrão.

Como se trabalha (não negociável)

  1. Um de cada vez e com seu OK. Apresente uma peça, aguarde sua exportação ou "próximo", corrija e só então passe para a seguinte. Nunca despache várias de uma vez.
  2. Cada peça pede seus recursos. A linguagem é comum (cores, tipografia, legendas); os recursos (rótulos, B-roll, zooms, palavra por trás) são decididos por frase. Não repita o mesmo truque em duas peças seguidas.
  3. Reaproveite o que já agradou. Se uma peça estava boa, deixe-a igual e retoque apenas o repetido ou o quebrado.
  4. Falha de design que você veja, avise. Não considere nada pronto sem ver a exportação.

Processo (uma tomada)

PassoComandoO que deixa
1. Limparpython limpiar.py <toma.mp4><toma>-limpia.mp4
2. Transcreverpython transcribir.py <toma>-limpia.mp4trabajo/transcripciones/tx (medium) e tx2 (turbo)
3. Cortarpython cortes.py <toma>-limpia.mp4trabajo/<toma>-limpia/CORTE.mp4, CORTE.txt, tramos.json
4. Revisão do corteo usuário vê CORTE.mp4 (traz o segundo ORIGINAL em um canto)
5. Corrigirpython cortes.py <toma>-limpia.mp4 --fora "17-45.5,53-58.6"novo corte
6a. Final sem CapCutpython subtitular.py <toma>-limpia.mp4 --chave "palavra1,palavra2"FINAL.mp4
6b. Projeto CapCutpython montar_reel.py spec.jsonprojeto editável no CapCut
7. Músicapython anadir_musica.py <projeto> <musica.mp3> <vol> <desde_s>faixa de música sob a voz
8. Exportaro usuário faz no CapCut (não pode ser automatizado)
9. Revisarpython revisar_volumen.py <final.mp4>volume e <final>-hoja.jpg com a zona segura
10. Capasa partir de um fotograma real (veja abaixo)
  • No passo 3, leia CORTE.txt: lista possíveis repetições (frases ditas duas vezes). Proponha remover a primeira versão com --fora, mas deixe o usuário decidir vendo o vídeo.
  • Com roteiro é muito melhor. Antes de cortar, pergunte se ele tem o roteiro. Se existir <toma>.guion.txt ao lado do vídeo (uma frase por linha; se usar um painel de conteúdo, pode baixá-lo de lá), CORTE.txt traz "CONTRA O ROTEIRO": as linhas ditas várias vezes (proponha ficar com a última tomada), as frases que fogem do roteiro (possíveis sobras ou arranques falhados) e as linhas que não foram ditas. Proponha, não aplique sozinho.
  • Além disso, leia você mesmo. As listas de cortes.py só veem repetições quase literais (medido em 4 tomadas reais: encontra 27% do que o usuário removeu manualmente). Após executá-lo, leia você a transcrição medium palavra por palavra com seus segundos (<transcripciones>/tx/<toma>.json, e o roteiro se houver) e marque os intervalos que sobram para ficar com UMA passagem limpa de cada ideia, normalmente a ÚLTIMA vez que a diz por inteiro: arranques falhados, frases repetidas mesmo que com outras palavras, "me enrolei". Nunca remova algo que só é dito uma vez. Medido com as mesmas 4 tomadas, ler assim encontrou 83% do removido manualmente, mas também propôs remover algo bom (21 s de 135 s que ficavam): por isso SEMPRE é apresentado como proposta no vídeo de revisão, com --fora, e o usuário decide.
  • "Remova de X a Y" usa sempre segundos do ORIGINAL (os que se veem no canto do CORTE), não do vídeo cortado.
  • Veja você a folha de fotogramas (Read sobre o .jpg) antes de dizer que está bom: nada importante acima da linha vermelha superior (y 288), abaixo da linha inferior (y 1267) nem à direita da linha amarela (x 930).
  • Para o spec de montar_reel.py, o molde é {{REPO}}\exemplos\spec_exemplo.py (um reel real com todos os recursos e os estilos ORGANICO / ANUNCIO). Chaves mínimas: nome, video, fim, palavras, palavras_subt, tramos (ou fora) e pecas_dir.
  • Para retocar um projeto CapCut já montado sem refazê-lo: anadir_musica.py, anadir_sonido.py, cambiar_clip.py, podar_sonido.py.

Regras padrão (medidas em uma série real de 10 reels)

  • Corte: conserva-se desde 0,10 s antes da primeira palavra até 0,18 s depois da última; dois trechos são unidos se o buraco for menor que 0,55 s. Se existir mi-estilo/aprendido.json, cortes.py usa seus valores.
  • Áudio: highpass 80 Hz + eq suave em 3,2 kHz + loudnorm em duas passadas (-15 LUFS, pico -2). Sem compressor nem redutor de ruído: eles aumentam o ruído de fundo.
  • Legendas: MAIÚSCULAS, branco com borda preta, palavra-chave na cor cor_chave do config, blocos de 1 a 3 palavras e no máximo 14 letras.
  • Rótulos: PNG 1080x1920, branco + palavra na cor chave, sombra dura, a 88% (para respirar).
  • Rótulo e legenda nunca se sobrepõem. Em orgânico a legenda desce (leg_y_baixo -0,37); em anúncio o rótulo sobe e a legenda desce para -0,255 (sem ultrapassar y 1267). Se a camada ocupar a parte inferior, a legenda é ocultada.
  • Hierarquia (linha pequena + palavra-chave grande) em dois textos separados: se tamanhos forem misturados em um, o CapCut os desalinha.
  • Multicâmera falso: trechos alternados a 130% e zooms a 138% nas frases fortes.
  • Zona segura de anúncio do Instagram: útil y 288-1267, botões à direita a partir de x 930. Orgânico: 250 / 420. Os cartões pequenos de B-roll vão à esquerda, na altura dos olhos (escala 0,22, x -0,60, y 0,30): à direita tapam o rosto ou caem sob os botões.
  • Poucos efeitos sonoros e com motivo (batida no rótulo, tique nas listas). Mais de uma dúzia em um reel é demais. Nenhum efeito pode ultrapassar o final do vídeo.
  • Música livre para promover: Pixabay ou Mixkit. Volume 0,06-0,07 com Pixabay e 0,13-0,14 com Mixkit (as do Pixabay soam cerca de 7 dB mais alto). Nada de hinos nem músicas famosas: o Meta bloqueia o anúncio.
  • B-roll apenas do Pexels (ferramentas/pexels_buscar.mjs, precisa de PEXELS_API_KEY em {{REPO}}\.env). Música e efeitos do Mixkit ou Pixabay. Nunca use material de outras contas no vídeo final.

Armadilhas conhecidas

  • CapCut aberto sobrescreve as alterações: seu autossalvamento sobrescreve o que montar_reel.py escreve. Peça ao usuário que feche o CapCut ANTES de montar, e que o reinicie para ver o projeto novo (não vê projetos novos a quente).
  • Exportar do CapCut é manual: não pode ser automatizado. Se o usuário não quiser CapCut, use subtitular.py.
  • Nada importante atrás da cabeça: ela tapa. Coloque na frente, na altura do peito e grande.
  • Se a pasta do projeto destino existir, o VectCutAPI a apaga: use sempre um nome novo (-v2, -v3).
  • Para limpar projetos do CapCut: mova, não apague, e apenas com o CapCut fechado.
  • Os botões do CapCut não são acessíveis à automação. Não faça cliques cegos: peça ao usuário que abra ele o projeto.
  • Na revisão da exportação, meça onde o texto cai em pixels: uma captura a meio da animação engana.
  • O final da tomada, quando a mão vai para o celular ou teleprompter, não é detectado bem: revise a olho e corte com --fim.
  • As muletas não se removem sozinhas. As legendas podem ter erros de transcrição: leia-as antes de entregar.
  • A primeira transcrição baixa os modelos do Whisper (vários GB): avise que demora.

Capas

  • O fotograma real inteiro, iluminado e com seu fundo. Nunca a pessoa recortada e colada sobre outro fundo nem fundos escuros.
  • A frase-chave em caixa colorida com letra da cor da marca, uma linha branca acima e, se for o caso, uma etiqueta pequena.
  • O bloco de texto abaixo do queixo e inteiro dentro do recorte 3:4 da grade do perfil (y 240-1680).
  • Faça-as com Pillow e rotulos_lib.py (fontes e cores de config.json). Se usar IA para melhorar o gesto, entregam-se as duas versões e a versão com IA leva a etiqueta "Feito com IA" do Meta.

Personalização

A. Seu estilo escrito: mi-estilo/estilo.md

Modelo para o usuário dizer como quer seus reels. Toda vez que o usuário corrigir algo ("não corte tão junto", "a chave sempre em vermelho", "mais rápido"), adicione em "Correções aprendidas" de estilo.md com a data, e aplique a partir desse momento. Se a correção for um número (margem, intervalo, tamanho, cor), mude também em aprendido.json ou em config.json.

B. Aprender de seus reels

Quando disser "aprenda de meus reels" ou "aprenda como edito":

  1. Peça que copie para mi-estilo/mis-reels/ entre 3 e 10 reels seus já publicados (os .mp4 exportados).
  2. python analizar_reels.py mis-reels -> mi-estilo/mis-reels.json (duração, segundos por plano, palavras por segundo, volume, gancho dos 3 primeiros segundos, fechamento) e uma folha de fotogramas por vídeo.
  3. Veja as folhas (Read de cada *-hoja.jpg): tamanho, posição e cor das legendas, se usa rótulos, B-roll, zooms, enquadramento.
  4. Se tiver projetos do CapCut onde corrigiu manualmente um corte automático, compare-os: python aprender_corte.py <toma-limpia.mp4> <projeto_capcut> [...] -> mi-estilo/aprendido.json (margem antes e depois de cada corte e intervalos que não corta). cortes.py o usa automaticamente.
  5. Escreva mi-estilo/aprendido.md: o medido (com os números) e o visto nas folhas, em regras concretas ("legendas a meia altura, 2 palavras, amarelo"). Não invente: se algo não se vê, não coloque.
  6. Mostre o resumo e pergunte se ele se reconhece. O que ele disser que não, remova.

C. Conta fantasma (reels de referência)

Quando disser "analise esta conta", "conta fantasma" ou "quero editar como este":

  1. Peça para colar os links dos reels em mi-estilo/referencias.txt (um por linha).
  2. python referencias.py: baixa-os com yt-dlp para mi-estilo/referencias/ e executa a análise (mi-estilo/referencias.json + folhas).
  3. Veja as folhas e escreva mi-estilo/referencias.md: o que essa conta faz (ritmo, gancho, legendas, rótulos, fechamento) e o que disso conflita com estilo.md, para o usuário escolher.
  4. As referências são um mapa, não um modelo: copia-se a estrutura (ritmo, tipo de gancho), nunca o texto, a música nem as imagens de outra conta.

Regras da conta fantasma:

  • Os vídeos baixados são apenas para analisá-los neste computador. Não são enviados, não são republicados e não saem de mi-estilo/referencias/ (está fora do git).
  • Nunca faça login no Instagram nem peça a senha do usuário. Se um link pedir login, pule.

Habilidades Relacionadas