/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ção | regra | etapa a refazer |
|---|---|---|
| duração | 40 a 68 s | roteiro |
| tamanho, fps, codecs | 1080x1920, 30 fps, h264 + aac | render / master |
| loudness, pico verdadeiro | -11,5 a -8,5 LUFS, <= -1 dBTP | master |
| início da voz | primeira palavra até 0,3 s | voz |
| pausas na voz | sem silêncio acima de 0,9 s entre falas | voz |
| voz sobre fundo | fala pelo menos 9 dB acima das pausas (música + SFX) | mix |
| movimento de gancho | algo se move nos primeiros 0,5 s | câmera |
| imagem muda constantemente | sem trecho de 2 s onde o quadro mal muda | câmera |
| cortes bruscos | no máximo 2 (deslizes de chicote não são cortes) | câmera |
| palavras coincidem com roteiro | taxa de erro de palavra <= 8% após trocas de legenda | voz |
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.mdsob## 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 comrender.js stills, depoisbash "$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 omake.shcompleto. - linha de voz: regrave essa linha (stickman3dmn:
retake.pyou 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.