/reel-critic
Un reel no está terminado hasta que pasa. Ejecuta esto después de que make.sh escriba <reel>/<name>.mp4.
PY es el Python del kit stickman (numpy): PY="$HOME/.claude/plugins/cache/claude-animation-skills/animation-skills/1.0.0/kit/.venv/bin/python". CRITIC="<directorio base de esta skill>".
1. Palabras
Transcribe el mp4 final: bash "$CRITIC/tools/stt.sh" <reel> [video] [mon|eng] (ElevenLabs Scribe vía Composio, escribe audio/stt_final.json).
Si la cuota de Composio ElevenLabs está vacía, transcribe el mp4 en la aplicación web de ElevenLabs (Speech to Text, Exporta JSON con marcas de tiempo) y guárdalo como audio/stt_final.json. Whisper es débil en mongol: no lo uses para reels en mongol.
2. Medir
"$PY" "$CRITIC/tools/critic.py" <reel> [video.mp4] escribe <reel>/critic/report.md, report.json y critic/sheets/sheet_NN.jpg (un fotograma por segundo, 10 por hoja; el fotograma i de la hoja NN está aproximadamente en NN*10 + i s). Código de salida 0 significa que todas las verificaciones medidas pasaron. Los umbrales están en rules.json:
| verificación | regla | paso a rehacer |
|---|---|---|
| duración | 40 a 68 s | guion |
| tamaño, fps, códecs | 1080×1920, 30 fps, h264 + aac | render / master |
| sonoridad, pico verdadero | −11.5 a −8.5 LUFS, ≤ −1 dBTP | master |
| inicio de la voz | primera palabra antes de 0.3 s | voz |
| pausas de voz | sin silencio de más de 0.9 s entre líneas | voz |
| voz sobre fondo | voz al menos 9 dB por encima de las pausas (música + SFX) | mezcla |
| movimiento inicial | algo se mueve en los primeros 0.5 s | cámara |
| la imagen cambia continuamente | sin estiramiento de 2 s donde el fotograma apenas cambia | cámara |
| cortes bruscos | máximo 2 (los deslizamientos whip no son cortes) | cámara |
| palabras coinciden con guion | tasa de error de palabra ≤ 8 % después de intercambios de subtítulos | voz |
3. Mirar
Lee cada hoja de contacto (apílalas: ffmpeg -i sheet_00.jpg -i sheet_01.jpg ... -filter_complex vstack=N). Recuadro cian: zona segura (x 100 a 980, y 220 a 1500). Banda amarilla: banda de subtítulos (y 1250 a 1420). Rechaza el reel por:
- una cara o el objeto clave de un momento debajo de la banda de subtítulos o fuera de la zona segura;
- el sujeto cortado por el borde del fotograma, o un objeto cerca del lente tapando al sujeto;
- un letrero o tarjeta de título con texto que el subtítulo cubre, o cualquier texto en inglés en pantalla en un reel en mongol;
- un momento cuya imagen no muestra lo que la voz dice en ese instante (revisa la palabra del subtítulo en cada fotograma);
- fotogramas rotos: negro, texturas faltantes, un personaje flotando o hundido en el suelo.
Un fotograma en medio de un deslizamiento whip puede estar borroso o mostrar suelo vacío: eso está bien. Escribe cada hallazgo con su tiempo y el paso a rehacer en report.md bajo ## Picture.
4. Veredicto y ciclo de corrección
PASA solo cuando el paso 2 sale con código 0, el paso 3 no tiene hallazgos y la lista de diferencias del paso 1 no tiene palabras que la voz realmente haya dicho mal (escucha las palabras listadas; los errores ortográficos del STT no cuentan).
En caso de FALLO, rehaz solo lo que falló, luego ejecuta los pasos 1 a 3 de nuevo. Detente después de 3 rondas y muestra al usuario lo que todavía falla.
- cámara / encuadre en algunos momentos: edita
web/shots.js, verifica conrender.js stills, luegobash "$CRITIC/tools/rerender.sh" <reel> <t1,t2,...>(vuelve a renderizar solo los planos que cubren esos tiempos, vuelve a concatenar, vuelve a masterizar). Un cambio en un set que aparece en muchos planos necesita elmake.shcompleto. - línea de voz: vuelve a grabar esa línea (stickman3dmn:
retake.pyo la aplicación web ElevenLabs), reconstruye los tiempos de palabras,make.sh <reel> keep. - mezcla / sonoridad: edita
audio.py,AUDIO_ONLY=1 make.sh <reel> keep. - guion / duración: vuelve al usuario; el guion es suyo para aprobar.
5. Aprender de números reales
python3 "$CRITIC/tools/stats.py" --out <reel>/critic/stats.json obtiene estadísticas de Instagram (vistas, compartidos, guardados, tiempo de visualización promedio) y estadísticas de video de TikTok a través de Composio. Omite una plataforma que no esté conectada (composio link instagram, composio link tiktok; las estadísticas de Instagram necesitan una cuenta de empresa o creador). Una vez que haya 10 o más publicaciones, compara el tercio superior con el resto (tiempo de visualización, duración, tipo de gancho) y propone cambios en rules.json al usuario antes de aplicarlos.
6. Entrega
Dale al usuario: la ruta del mp4, duración, sonoridad medida, la tabla de veredicto, hallazgos de imagen corregidos y un pie de foto para TikTok, Instagram y YouTube Shorts en el idioma del reel con 3 a 5 hashtags en inglés (siempre #whatif para el canal Hervee, más etiquetas de tema como #mongolia #ulaanbaatar, #fyp en TikTok, #shorts en YouTube). El usuario publica manualmente.
De dónde vienen las reglas
Consulta README.md: investigación de retención y gancho, mediciones de zona segura y las herramientas de automatización que se examinaron.