Studio Video Director
Eine kampferprobte, messungsgetriebene Pipeline zur Produktion von studioäquivalenten Videos mit kostenlosen lokalen Werkzeugen. Jede der folgenden Regeln wurde durch echte fehlgeschlagene Builds erkauft: Monomixe, überkomprimiertes Audio, Diashow-Shorts, abgeschnittene Untertitel und tote Luft. Ein Build, der eines der Gates verletzt, ist ein fehlgeschlagener Build – behebe es, versende es nicht.
Wann dieses Skill verwenden
- Jede Video-Lieferung: Hackathon-Demo, Produktdemo, Short/Reel, Film-Erklärvideo, Werbung, Tutorial, Trailer, Podcast-Clip.
- Vor dem Rendern: Planung, Skript, Storyboard, Shot-Prompts.
- Nach dem Rendern: Die 10-Gate-Vorauslieferung-Prüfung des FINALEN Encodes.
- Wenn ein Video "gut aussieht, aber amateurhaft wirkt": Führe das Gate aus, behebe die fehlgeschlagenen Gates, überprüfe erneut. Das Gate benennt den genauen Fehler.
Der 8-Schritte-Workflow
- Briefing – ein Absatz: Zielgruppe, eine Idee, ein CTA, Länge,
Seitenverhältnis (EINES auswählen und fixieren:
16:9Demo/Langform oder9:16Shorts/Reels – NIEMALS Verhältnisse in einem Projekt mischen). - Crew-Plan (6 Rollen) – Regie (Vision + Schnittliste), Autor (Skript, <=30 Wörter pro Einstellung, ~150 wpm), Kameramann (Kamera + Bildausschnitt), Art Director (Farbpalette + Set), VFX (Bewegung + Übergänge), Sound-Designer (VoiceOver + Musik + SFX). Jede Rolle gibt vor der Generierung das OK.
- Storyboard + Schnittliste – VOR dem Animieren schreiben. Ein visueller oder Kamerabildschnitt mindestens alle 3-4 s (kein Abstand > 4 s, harter Fehler). Hook in den ersten 3 s: Titel/Frage + Bewegung. Niemals ein statischer Opener auf dem Cover.
- Prompts (sechsteilig) – pro Segment, <=10 s lang, unter Verwendung von
references/prompt-template.md: Dauer/Format, Subjekt, Szene, Beats mit Zeitstempeln, Kamerasprache, Ton/Dialog, Einschränkungen. Die Subjektbeschreibung WÖRTLICH über Segmente hinweg wiederverwenden. - Segmente generieren – nur echte Bewegung: Bildschirmaufnahme (Playwright, deviceScaleFactor 2, 1920x1080@30fps für Demos), B-Roll oder Animation. Ken Burns auf Standbildern: maximal EIN Segment von <=4 s pro Short, niemals das ganze Video.
- Zusammenbau – jede Szene auf das fixierte Bild normalisieren
(skalieren + auffüllen, niemals strecken), mit dem Concat-Demuxer zusammenfügen, den Ton
meistern (Pro:
pro-bundle/scripts/assemble_multiscene.py). - Ton – nur neuronales VoiceOver (edge-tts / Studio TTS; gTTS verboten). Musik: ein echter lizenzierter Track (Mixkit / Pixabay / YouTube Audio Library), auf -20 dB (Shorts) oder -22 dB (Demos) unter dem VO geduckt. Echte designede SFX, synchronisiert zu den Schnitten. Synthetische Betten/SFX verboten.
- Gate + Lieferung –
scripts/quality_gate.pyauf dem FINALEN Encode ausführen. Alle 10 Gates müssen BESTANDEN sein. Master + .SRT inrenders/speichern und niemals löschen.
Qualitäts-Gates (alle 10, keine Ausnahmen)
| # | Gate | Regel |
|---|---|---|
| 1 | Spezifikationen | exakte Dauer/Auflösung/fps; Audiokanäle == 2 |
| 2 | Lautstärke | integriert -14..-16 LUFS, TP <= -1,5 dBTP, LRA >= 6 LU |
| 3 | Tote Luft | keine Stille >= 0,5 s außer einem nachlaufenden Ende <= 1 s |
| 4 | Schnitt-Rhythmus | kein Abstand zwischen Schnitten > 4 s |
| 5 | Sprachabdeckung | faster-whisper Transkript deckt >= 80 % der Skriptwörter ab |
| 6 | Bilder | Bilder 00:02 / Mitte / Ende bestehen die benannte Bild-Checkliste |
| 7 | Stereo | ffprobe Kanäle == 2 im finalen Mix |
| 8 | Echte Musik/SFX | Mensch bestätigt echte lizenzierte Musik + echte SFX |
| 9 | Keine Diashow | kein eingefrorenes Segment > 4 s |
| 10 | Master-Schutz | .SRT Sidecar vorhanden, keine *-broken / *-v1 / *-v2 Geschwister |
Ausführen:
python3 scripts/quality_gate.py final.mp4 --aspect 16:9 \
--srt final.srt --script vo-script.txt --frames-dir checks/
Einzelne Gates:
python3 scripts/audio_lufs_check.py final.mp4
python3 scripts/extract_frames_check.py final.mp4 --aspect 16:9 --frames-dir checks/
Untertitel-Regeln
- 16:9 Demos: separater
.SRTSidecar NUR. Keine eingebrannten Erzähl-Untertitel. On-Screen UI-Einblendungen sind erlaubt – sie sind keine Untertitel. - 9:16 Shorts/Reels:
.SRTSidecar UND stilisierte, im unteren Drittel sichere Zone eingebrannte Untertitel (der Shorts-Player ignoriert Sidecars; stummgeschaltete Zuschauer benötigen Bildschirmtext).
Benannte Bild-Checkliste (anwenden auf Bilder 00:02, Mitte, Ende)
(a) nichts an einer Kante abgeschnitten, (b) keine toten Bänder/leeren Bereiche > 25 % des Bildes, (c) jedes Bildschirmwort in Telefongröße lesbar, (d) Untertitel sichtbar, wo das Skript sie vorgesehen hat, (e) keine Platzhalter-/falsche UI-Texte, (f) Subjekt füllt das Bild.
$0 Werkzeuge (kostenloser Tarif)
- ffmpeg / ffprobe 8.x, Python 3.10+, faster-whisper (lokal, CPU).
- Optionale externe kostenlose Credits nur (OpusClip / Vizard / Quso / 2short kostenlose Tarife) – werden von keinem Skript in diesem Repository aufgerufen, niemals eine kostenpflichtige API, niemals eine Anmeldung, niemals eine Karte.
- Dieses Repository enthält KEINE Anmeldedaten, KEINE API-Schlüssel, KEINE persönlichen Daten.
Pro Edition
pro-bundle/ fügt hinzu: Multi-Szenen FFmpeg-Zusammenbau mit Two-Pass-
Loudnorm-Mastering, VO + Musik automatischem Ducking, Whisper .SRT + eingebranntem
Untertitel-Builder, 18 Nischenvorlagen und einem Ein-Befehl-Batch-Gate.
Siehe README.md (Pro Edition Abschnitt) und pro-bundle/README.md.