Communitygithub.com

reel-critic

Examine une vidéo terminée au format 9:16 (TikTok, Instagram Reels, YouTube Shorts) avant publication et la renvoie en correction jusqu'à ce qu'elle soit conforme. Mesure la durée, le format, le niveau sonore, le calage de la voix, l'équilibre voix/musique, le mouvement d'accroche, les étirements d'image et les coupures brusques, vérifie les paroles par rapport au script, puis Claude analyse les planches-contact pour détecter les problèmes de cadrage, de bande de sous-titres et de zone de sécurité. En cas d'échec, seule l'étape défaillante est reprise (un plan, une ligne de voix, le mixage), jusqu'à 3 rounds. Termine avec le sous-titre et des hashtags en anglais.

Qu'est-ce que reel-critic ?

Ce skill permet de **review automatisée de vidéos courtes 9:16** (TikTok, Instagram Reels, YouTube Shorts) avant leur publication. Il combine des **mesures techniques** (durée, format, codecs, niveau sonore LUFS, timing de la voix, mouvement d'accroche, absence d'étirements d'image et de coupures brutales) avec une **analyse visuelle par Claude** sur des planches-contact (captures d'écran) pour détecter les problèmes de cadrage, de zone de sécurité (cyan) et de bande de sous-titres (jaune). Le skill fonctionne en **boucle de correction ciblée** : si une mesure échoue, seule l'étape correspondante est reprise (par exemple, réenregistrer une ligne de voix, modifier le mixage audio, ou re-rendre certains plans avec `rerender.sh`). Un maximum de 3 tentatives est autorisé avant de remonter le problème à l'utilisateur. Il s'appuie sur **Composio pour la transcription (ElevenLabs Scribe)** et la récupération de **statistiques de publication** (Instagram Insights, TikTok Stats). Les règles de validation sont dans `rules.json` et peuvent être mises à jour automatiquement après au moins 10 posts en comparant les performances (watch time, longueur, type d'accroche). **Cas d'usage typique** : après chaque build `/stickman3d` ou `/stickman3dmn`, ou quand l'utilisateur demande une review, critique ou QA d'une vidéo courte.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

/reel-critic

Une vidéo n'est pas terminée tant qu'elle n'a pas réussi ce contrôle. Exécutez cette commande après que make.sh a écrit <reel>/<name>.mp4. PY est le Python du kit stickman (numpy) : PY="$HOME/.claude/plugins/cache/claude-animation-skills/animation-skills/1.0.0/kit/.venv/bin/python". CRITIC="<répertoire de base de ce skill>".

1. Paroles

Transcrivez le mp4 final : bash "$CRITIC/tools/stt.sh" <reel> [video] [mon|eng] (ElevenLabs Scribe via Composio, écrit audio/stt_final.json). Si le quota Composio ElevenLabs est épuisé, transcrivez le mp4 dans l'application web ElevenLabs (Speech to Text, Export JSON avec timestamps) et sauvegardez-le sous audio/stt_final.json. Whisper est peu fiable pour le mongol : ne l'utilisez pas pour les vidéos en mongol.

2. Mesures

"$PY" "$CRITIC/tools/critic.py" <reel> [video.mp4] écrit <reel>/critic/report.md, report.json et critic/sheets/sheet_NN.jpg (une image par seconde, 10 par planche ; l'image i de la planche NN correspond environ à NN*10 + i s). Le code de sortie 0 signifie que toutes les vérifications mesurées sont réussies. Les seuils se trouvent dans rules.json :

vérificationrègleétape de reprise
durée40 à 68 sscript
taille, fps, codecs1080x1920, 30 fps, h264 + aacrendu / master
niveau sonore, pic vrai-11.5 à -8.5 LUFS, <= -1 dBTPmaster
début de la voixpremier mot avant 0.3 svoix
silences vocauxpas de silence de plus de 0.9 s entre les lignesvoix
voix sur fond sonoreparole au moins 9 dB au-dessus des pauses (musique + SFX)mixage
mouvement d'accrochequelque chose bouge dans les 0.5 premières secondescaméra
l'image change continuellementpas d'étirement de 2 s où l'image change à peinecaméra
coupures brusquesau maximum 2 (les transitions whip ne sont pas des coupures)caméra
paroles correspondent au scripttaux d'erreur de mots <= 8 % après échanges de sous-titresvoix

3. Examen visuel

Lisez chaque planche-contact (empilez-les : ffmpeg -i sheet_00.jpg -i sheet_01.jpg ... -filter_complex vstack=N). Boîte cyan : zone de sécurité (x 100 à 980, y 220 à 1500). Bande jaune : bande de sous-titres (y 1250 à 1420). Échouez la vidéo pour :

  • un visage ou l'objet clé d'une scène sous la bande de sous-titres ou hors de la zone de sécurité ;
  • le sujet coupé par le bord de l'image, ou un objet proche de l'objectif couvrant le sujet ;
  • un panneau ou une carte-titre dont le texte est recouvert par le sous-titre, ou tout texte anglais à l'écran dans une vidéo en mongol ;
  • une scène dont l'image ne montre pas ce que la voix dit à ce moment (vérifiez le mot du sous-titre sur chaque image) ;
  • images cassées : noir, textures manquantes, personnage flottant ou enfoncé dans le sol. Une image au milieu d'une transition whip peut être floue ou montrer un sol vide : c'est acceptable. Écrivez chaque constat avec son heure et l'étape de reprise dans report.md sous ## Image.

4. Verdict et boucle de correction

RÉUSSI uniquement lorsque l'étape 2 sort avec le code 0, l'étape 3 n'a aucun constat, et la liste des différences de l'étape 1 ne contient aucun mot que la voix a réellement mal prononcé (écoutez les mots listés ; les erreurs d'orthographe de la STT ne comptent pas). En cas d'ÉCHEC, ne reprenez que ce qui a échoué, puis exécutez à nouveau les étapes 1 à 3. Arrêtez après 3 rounds et montrez à l'utilisateur ce qui échoue encore.

  • caméra / cadrage à quelques moments : modifiez web/shots.js, vérifiez avec render.js stills, puis bash "$CRITIC/tools/rerender.sh" <reel> <t1,t2,...> (ne re-rend que les plans couvrant ces moments, re-concatène, re-master). Une modification d'un décor visible dans de nombreux plans nécessite le make.sh complet.
  • ligne de voix : réenregistrez cette ligne (stickman3dmn : retake.py ou l'application web ElevenLabs), reconstruisez les temps des mots, make.sh <reel> keep.
  • mixage / niveau sonore : modifiez audio.py, AUDIO_ONLY=1 make.sh <reel> keep.
  • script / durée : retour à l'utilisateur ; le script lui appartient.

5. Apprendre des chiffres réels

python3 "$CRITIC/tools/stats.py" --out <reel>/critic/stats.json récupère les insights Instagram Reels (vues, partages, sauvegardes, durée moyenne de visionnage) et les statistiques TikTok via Composio. Il saute une plateforme non connectée (composio link instagram, composio link tiktok ; les insights Instagram nécessitent un compte professionnel ou créateur). Une fois qu'il y a au moins 10 publications, comparez le tiers supérieur avec le reste (durée de visionnage, longueur, type d'accroche) et proposez des modifications de rules.json à l'utilisateur avant de les appliquer.

6. Remise

Donnez à l'utilisateur : le chemin du mp4, la durée, le niveau sonore mesuré, le tableau de verdict, les constats visuels corrigés, et un sous-titre pour TikTok, Instagram et YouTube Shorts dans la langue de la vidéo avec 3 à 5 hashtags en anglais (toujours #whatif pour la chaîne Hervee, plus des tags de sujet comme #mongolia #ulaanbaatar, #fyp sur TikTok, #shorts sur YouTube). L'utilisateur publie manuellement.

D'où viennent les règles

Voir README.md : rétention et recherche sur les accroches, mesures de zone de sécurité et outils d'automatisation examinés.

Skills associés