Communitygithub.com

reel-critic

Analisa e revisa um reel finalizado (TikTok, Instagram Reels, YouTube Shorts) antes da publicação, garantindo que atenda a todos os critérios de qualidade e fazendo correções automáticas até passar.

O que é reel-critic?

O Reel Critic é uma skill de agente de IA (como Claude Code, Cursor, Codex) projetada para revisar vídeos verticais 9:16 prontos – como TikToks, Reels e Shorts – antes da postagem. Ela realiza verificações técnicas (duração, formato, loudness, timing de voz, nível de voz sobre música), análise de movimento (hook, mudanças de cena, cortes bruscos) e comparação do áudio transcrito com o roteiro. Além disso, analisa visualmente cada fotograma via folhas de contato, identificando problemas de enquadramento, legendas sobrepostas a rostos ou objetos, e falhas gráficas. Se algo falhar, a skill refaz apenas o passo específico (cena, linha de voz, mixagem) em até 3 rodadas. Ao final, gera legendas e hashtags em inglês, prontas para publicação manual. Suporta integração com ElevenLabs para transcrição, Composio para estatísticas de redes sociais e pode ajustar automaticamente as regras com base no desempenho real dos posts.

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

Perguntar na sua IA favorita

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

Documentação

/reel-critic

Um reel só está pronto quando passa na revisão. Execute este comando depois que make.sh gerar <reel>/<name>.mp4. PY é o Python do kit stickman (numpy): PY="$HOME/.claude/plugins/cache/claude-animation-skills/animation-skills/1.0.0/kit/.venv/bin/python". CRITIC="<diretório base desta skill>".

1. Palavras

Transcreva o mp4 final: bash "$CRITIC/tools/stt.sh" <reel> [video] [mon|eng] (ElevenLabs Scribe via Composio, escreve audio/stt_final.json). Se a cota do ElevenLabs via Composio estiver esgotada, transcreva o mp4 no aplicativo web da ElevenLabs (Speech to Text, Exportar JSON com timestamps) e salve como audio/stt_final.json. Whisper é fraco em mongol: não o use para reels em mongol.

2. Medir

"$PY" "$CRITIC/tools/critic.py" <reel> [video.mp4] escreve <reel>/critic/report.md, report.json e critic/sheets/sheet_NN.jpg (um quadro por segundo, 10 por folha; o quadro i da folha NN está aproximadamente em NN*10 + i s). Código de saída 0 significa que todas as verificações medidas passaram. Os limites estão em rules.json:

verificaçãoregraetapa a refazer
duração40 a 68 sroteiro
tamanho, fps, codecs1080x1920, 30 fps, h264 + aacrender / master
loudness, pico verdadeiro-11,5 a -8,5 LUFS, <= -1 dBTPmaster
início da vozprimeira palavra até 0,3 svoz
pausas na vozsem silêncio acima de 0,9 s entre falasvoz
voz sobre fundofala pelo menos 9 dB acima das pausas (música + SFX)mix
movimento de ganchoalgo se move nos primeiros 0,5 scâmera
imagem muda constantementesem trecho de 2 s onde o quadro mal mudacâmera
cortes bruscosno máximo 2 (deslizes de chicote não são cortes)câmera
palavras coincidem com roteirotaxa de erro de palavra <= 8% após trocas de legendavoz

3. Olhar

Leia cada folha de contato (empilhe-as: ffmpeg -i sheet_00.jpg -i sheet_01.jpg ... -filter_complex vstack=N). Caixa ciano: zona segura (x 100 a 980, y 220 a 1500). Faixa amarela: faixa de legenda (y 1250 a 1420). Reprove o reel por:

  • um rosto ou o objeto principal de uma cena abaixo da faixa de legenda ou fora da zona segura;
  • o sujeito cortado pela borda do quadro, ou um objeto próximo à lente cobrindo o sujeito;
  • um cartaz ou título com texto que a legenda cubra, ou qualquer texto em inglês na tela em um reel mongol;
  • uma cena cuja imagem não mostra o que a voz diz naquele momento (verifique a palavra da legenda em cada quadro);
  • quadros quebrados: preto, texturas faltando, um personagem flutuando ou afundado no chão. Um quadro no meio de um deslize de chicote pode estar borrado ou mostrar chão vazio: isso é aceitável. Escreva cada problema com seu horário e a etapa a refazer em report.md sob ## Imagem.

4. Veredito e ciclo de correção

APROVADO apenas quando a etapa 2 sair com código 0, a etapa 3 não tiver problemas, e a lista de diferenças da etapa 1 não contiver palavras que a voz realmente errou (ouça as palavras listadas; erros de ortografia do STT não contam). Em caso de REPROVAÇÃO, refaça apenas o que falhou e execute as etapas 1 a 3 novamente. Pare após 3 rodadas e mostre ao usuário o que ainda falha.

  • câmera / enquadramento em alguns momentos: edite web/shots.js, verifique com render.js stills, depois bash "$CRITIC/tools/rerender.sh" <reel> <t1,t2,...> (re-renderiza apenas as tomadas que cobrem aqueles horários, re-concatena, re-masteriza). Uma alteração em um cenário visto em muitas tomadas requer o make.sh completo.
  • linha de voz: regrave essa linha (stickman3dmn: retake.py ou o aplicativo web ElevenLabs), reconstrua os tempos das palavras, make.sh <reel> keep.
  • mix / loudness: edite audio.py, AUDIO_ONLY=1 make.sh <reel> keep.
  • roteiro / duração: de volta ao usuário; o roteiro é dele para aprovar.

5. Aprenda com números reais

python3 "$CRITIC/tools/stats.py" --out <reel>/critic/stats.json puxa insights do Instagram (visualizações, compartilhamentos, salvamentos, tempo médio de exibição) e estatísticas do TikTok via Composio. Ele pula uma plataforma que não está conectada (composio link instagram, composio link tiktok; insights do Instagram precisam de uma conta comercial ou de criador). Quando houver 10 ou mais posts, compare o terço superior com o restante (tempo de exibição, duração, tipo de gancho) e proponha alterações em rules.json ao usuário antes de aplicá-las.

6. Entrega

Forneça ao usuário: o caminho do mp4, duração, loudness medida, a tabela de veredito, problemas de imagem corrigidos, e uma legenda para TikTok, Instagram e YouTube Shorts no idioma do reel com 3 a 5 hashtags em inglês (sempre #whatif para o canal Hervee, mais tags de tópico como #mongolia #ulaanbaatar, #fyp no TikTok, #shorts no YouTube). O usuário posta manualmente.

De onde vêm as regras

Veja README.md: pesquisa de retenção e gancho, medições de zona segura e as ferramentas de automação que foram analisadas.

Habilidades Relacionadas