Communitygithub.com

reel-critic

Revisa un reel en formato 9:16 (TikTok, Instagram Reels, YouTube Shorts) antes de publicarlo y lo envía a corregir hasta que pase todas las verificaciones.

¿Qué es reel-critic?

reel-critic es una skill automatizada de control de calidad para reels en formato vertical 9:16, diseñada para funcionar después de la construcción del video (por ejemplo, con herramientas como stickman3d). Evalúa aspectos técnicos y visuales: mide la duración (40-68 s), formato (1080×1920, 30 fps), loudness (−11.5 a −8.5 LUFS), tiempos de voz, solapamiento voz-música, movimiento inicial, cambios de plano y dureza de cortes. También transcribe el audio con ElevenLabs Scribe (o alternativa manual) y compara las palabras habladas con el guion, calculando la tasa de error. Además, revisa visualmente las hojas de contacto (fotogramas cada segundo) para detectar problemas de encuadre, texto en zonas inseguras, objetos o personajes fuera del área segura, y errores de render. En caso de fallo, la skill rehace únicamente el paso fallido (una línea de voz, un plano, la mezcla) hasta tres rondas, y finalmente entrega el metraje aprobado junto con una leyenda y hashtags en inglés. Es compatible con Claude Code y se invoca después de cada compilación de reel o cuando el usuario solicita una revisión, crítica o QA.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

/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ónreglapaso a rehacer
duración40 a 68 sguion
tamaño, fps, códecs1080×1920, 30 fps, h264 + aacrender / master
sonoridad, pico verdadero−11.5 a −8.5 LUFS, ≤ −1 dBTPmaster
inicio de la vozprimera palabra antes de 0.3 svoz
pausas de vozsin silencio de más de 0.9 s entre líneasvoz
voz sobre fondovoz al menos 9 dB por encima de las pausas (música + SFX)mezcla
movimiento inicialalgo se mueve en los primeros 0.5 scámara
la imagen cambia continuamentesin estiramiento de 2 s donde el fotograma apenas cambiacámara
cortes bruscosmáximo 2 (los deslizamientos whip no son cortes)cámara
palabras coinciden con guiontasa de error de palabra ≤ 8 % después de intercambios de subtítulosvoz

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 con render.js stills, luego bash "$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 el make.sh completo.
  • línea de voz: vuelve a grabar esa línea (stickman3dmn: retake.py o 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.

Skills relacionados