Communitygithub.com

Reel-Kritiker

Überprüft ein fertiges 9:16-Reel (TikTok, Instagram Reels, YouTube Shorts) vor der Veröffentlichung und schickt es zur Nachbesserung zurück, bis es besteht.

Was ist Reel-Kritiker?

Der Reel-Kritiker ist ein KI-gestützter Qualitätsprüfer für vertikale Kurzvideos (9:16). Er analysiert ein fertiges MP4-File auf Länge, Format, Lautstärke, Timing von Stimme und Musik, Bewegungen im Hook, Standbild-Strecken und harte Schnitte. Zusätzlich vergleicht es die gesprochenen Wörter mit dem Drehbuch und prüft Bildkontaktbögen auf Probleme mit Rahmung, Caption-Band und Sicherheitszone. Der Kritiker unterstützt Plattformen wie Claude Code, Cursor und Codex und arbeitet mit einem schrittweisen Fehlerbehebungsprozess: Pro Fehlschlag wird nur der fehlgeschlagene Schritt wiederholt (z. B. ein einziger Shot, eine Sprachzeile oder der Mix) – maximal drei Runden. Am Ende erstellt er eine Bildunterschrift mit englischen Hashtags. Dieses Werkzeug ist ideal für Entwickler, die nach jedem `/stickman3d`- oder `/stickman3dmn`-Build eine automatische Qualitätskontrolle durchführen möchten.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

/reel-critic

Ein Reel ist erst fertig, wenn es besteht. Führen Sie dies aus, nachdem make.sh <reel>/<name>.mp4 geschrieben hat. PY ist das Stickman-Kit Python (numpy): PY="$HOME/.claude/plugins/cache/claude-animation-skills/animation-skills/1.0.0/kit/.venv/bin/python". CRITIC="<Basisverzeichnis dieses Skills>".

1. Wörter

Transkribieren Sie das endgültige mp4: bash "$CRITIC/tools/stt.sh" <reel> [video] [mon|eng] (ElevenLabs Scribe via Composio, schreibt audio/stt_final.json). Wenn das Composio-ElevenLabs-Kontingent leer ist, transkribieren Sie das mp4 in der ElevenLabs-Web-App (Sprache-zu-Text, Export JSON mit Zeitstempeln) und speichern Sie es als audio/stt_final.json. Whisper ist bei Mongolisch schwach: Verwenden Sie es nicht für mongolische Reels.

2. Messen

"$PY" "$CRITIC/tools/critic.py" <reel> [video.mp4] schreibt <reel>/critic/report.md, report.json und critic/sheets/sheet_NN.jpg (ein Frame pro Sekunde, 10 pro Blatt; Frame i von Blatt NN ist etwa bei NN*10 + i s). Exit-Code 0 bedeutet, dass alle gemessenen Prüfungen bestanden wurden. Schwellwerte befinden sich in rules.json:

PrüfungRegelNachbesserungsschritt
Länge40 bis 68 sDrehbuch
Größe, fps, Codecs1080x1920, 30 fps, h264 + aacRendern / Master
Lautstärke, True Peak-11.5 bis -8.5 LUFS, <= -1 dBTPMaster
Stimme startetErstes Wort bei 0.3 sStimme
SprachlückenKeine Stille über 0.9 s zwischen ZeilenStimme
Stimme über MusikSprache mindestens 9 dB über den Pausen (Musik + SFX)Mix
Hook-BewegungEtwas bewegt sich in den ersten 0.5 sKamera
Bild ändert sich ständigKeine 2-s-Strecke mit kaum verändertem FrameKamera
Harte SchnitteMaximal 2 (Peitschengleiten sind keine Schnitte)Kamera
Wörter passen zum DrehbuchWortfehlerrate <= 8 % nach Untertitel-AustauschStimme

3. Anschauen

Lesen Sie jeden Kontaktbogen ein (stapeln Sie sie: ffmpeg -i sheet_00.jpg -i sheet_01.jpg ... -filter_complex vstack=N). Cyan-Kasten: Sicherheitszone (x 100 bis 980, y 220 bis 1500). Gelbes Band: Caption-Band (y 1250 bis 1420). Das Reel fällt bei:

  • einem Gesicht oder dem Schlüsselobjekt eines Beats unter dem Caption-Band oder außerhalb der Sicherheitszone;
  • das Motiv durch den Bildrand abgeschnitten oder ein Objekt nahe der Linse, das das Motiv verdeckt;
  • ein Schild oder Titelbild mit Text, den die Bildunterschrift überdeckt, oder englischer Text auf dem Bildschirm in einem mongolischen Reel;
  • ein Beat, dessen Bild nicht zeigt, was die Stimme in diesem Moment sagt (überprüfen Sie das Untertitelwort auf jedem Frame);
  • kaputte Frames: schwarz, fehlende Texturen, eine schwebende oder im Boden versunkene Figur. Ein Frame in der Mitte einer Peitschengleitbewegung kann unscharf sein oder leeren Boden zeigen: das ist in Ordnung. Schreiben Sie jeden Befund mit seiner Zeit und dem Nachbesserungsschritt in report.md unter ## Bild.

4. Befund und Fehlerbehebungs-Loop

BESTANDEN nur, wenn Schritt 2 mit 0 beendet wird, Schritt 3 keine Befunde hat und die Diff-Liste von Schritt 1 kein Wort enthält, das die Stimme tatsächlich falsch hatte (hören Sie sich die aufgeführten Wörter an; STT-Rechtschreibfehler zählen nicht). Bei FEHLSCHLAG nur das wiederholen, was fehlgeschlagen ist, dann Schritte 1 bis 3 erneut ausführen. Nach 3 Runden anhalten und dem Benutzer zeigen, was immer noch fehlschlägt.

  • Kamera / Rahmung zu bestimmten Zeiten: web/shots.js bearbeiten, mit render.js stills prüfen, dann bash "$CRITIC/tools/rerender.sh" <reel> <t1,t2,...> (rendert nur die Shots, die diese Zeiten abdecken, neu, macht neues Concatenate, neues Mastering). Eine Änderung an einem Set, das in vielen Shots zu sehen ist, benötigt das vollständige make.sh.
  • Sprachzeile: Diese Zeile neu aufnehmen (stickman3dmn: retake.py oder die ElevenLabs-Web-App), Wortzeiten neu berechnen, make.sh <reel> keep.
  • Mix / Lautstärke: audio.py bearbeiten, AUDIO_ONLY=1 make.sh <reel> keep.
  • Drehbuch / Länge: zurück zum Benutzer; das Drehbuch ist deren Sache zur Genehmigung.

5. Aus echten Zahlen lernen

python3 "$CRITIC/tools/stats.py" --out <reel>/critic/stats.json ruft Instagram-Reel-Einblicke (Aufrufe, geteilte Inhalte, gespeicherte Inhalte, durchschnittliche Betrachtungszeit) und TikTok-Videostatistiken über Composio ab. Es überspringt eine Plattform, die nicht verbunden ist (composio link instagram, composio link tiktok; Instagram-Einblicke benötigen ein Geschäfts- oder Erstellerkonto). Sobald 10 oder mehr Beiträge vorhanden sind, vergleichen Sie das obere Drittel mit dem Rest (Betrachtungszeit, Länge, Hook-Typ) und schlagen Sie dem Benutzer rules.json-Änderungen vor, bevor sie umgesetzt werden.

6. Übergabe

Geben Sie dem Benutzer: den mp4-Pfad, Länge, gemessene Lautstärke, die Befundtabelle, korrigierte Bildbefunde und eine Bildunterschrift für TikTok, Instagram und YouTube Shorts in der Sprache des Reels mit 3 bis 5 englischen Hashtags (immer #whatif für den Hervee-Kanal, dazu thematische Tags wie #mongolia #ulaanbaatar, #fyp auf TikTok, #shorts auf YouTube). Der Benutzer postet manuell.

Woher die Regeln kommen

Siehe README.md: Forschung zu Bindung (Retention) und Hooks (Hook), Sicherheitszonenmessungen und die angesehenen Automatisierungswerkzeuge.

Verwandte Skills