Communitygithub.com

DotanVG/video-director-skill

Regie führen, schneiden und professionelle Videos von Anfang bis Ende mit HyperFrames produzieren – sowohl als Regisseur (Story, Hook, Drehbuch, Shot-Liste, Musik) als auch als Editor (beat-synchrone Schnitte, Punch-Ins, Kinetic Type, Sounddesign, Farbe, Lautstärke, Multi-Format-Auslieferung).

Was ist video-director-skill?

Die Video Director Skill verwandelt einen KI-Agenten in einen vollwertigen Regisseur und Editor für professionelle Videoproduktion mit HyperFrames. Sie deckt den gesamten Workflow ab: von der strukturierten Projektaufnahme (Intake) über die Erstellung von Drehbüchern und Musik-Rastern bis hin zum tatsächlichen Bau und Export von Videos. Die Skill unterstützt verschiedene Formate wie Trailer, Teaser, Promos, Launch-Videos, Sizzle Reels, Social Cuts, Highlight Reels, App Previews und Game-Trailer (Steam, itch.io, Game Jams, App Stores). Sie arbeitet mit Plattformen wie Claude Code, Cursor und Codex zusammen und nutzt eine Reihe von Sub-Skills (z. B. HyperFrames Core, Animation, Keyframes, Audio) für spezifische Aufgaben wie Komposition, Bewegung, Kamerafahrten oder Audiobearbeitung. Die Skill stellt sicher, dass alle Schritte lokal ausgeführt werden, ohne Cloud-Rendering oder kostenpflichtige Dienste ohne explizite Zustimmung des Nutzers. Ein besonderer Fokus liegt auf harter Arbeit: Sie überprüft Rohmaterial mit ffprobe und Kontaktbögen, erstellt Timing-Tabellen, wählt Musik aus, justiert Beats und führt eine umfassende Qualitätskontrolle vor der Auslieferung durch. Die Skill enthält viele praxiserprobte Regeln, die aus früheren Rendering-Fehlern gewonnen wurden, wie etwa die korrekte Handhabung von GSAP-Animationen oder die Vermeidung von Desktop-Benachrichtigungen in Bildschirmaufnahmen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DotanVG/video-director-skill/tree/HEAD/video-director

In Ihrer bevorzugten KI fragen

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

Dokumentation

Video Director

Du bist der Regisseur und der Editor. HyperFrames ist die Kamera, die Timeline und der Render-Farm. Diese Skill besitzt das Handwerk und den Prozess (Intake, Treatment, Edit-Plan, Sound, Look, QA, Delivery). Die HyperFrames-Skills besitzen den Kompositionsvertrag. Lade sie; leite ihre Regeln nicht aus dem Gedächtnis ab.

Wie diese Skill mit HyperFrames zusammenhängt

BedarfLaden
Kompositionsvertrag, data-*-Timing, Sub-Kompositionen, Medien, Variablen/hyperframes-core
Bewegungsregeln, GSAP-Adapter, Übergänge/hyperframes-animation
Punch-Ins, Schwenks, Zooms, Kamera-Keyframes/hyperframes-keyframes
Überblendungen, Spuren, Effektketten, Lautstärkeabgleich/hyperframes-audio
Footage-Behandlungen (Grade, Vignette), Beschaffung von BGM/SFX, TTS/media-use
CLI: init, lint, check, snapshot, render, beats/hyperframes-cli
Benannte Looks (Glitch, CRT, Light Leak) vor dem manuellen Bauen/hyperframes-registry

Wenn eine dieser Skills fehlt, führe zuerst npx hyperframes skills update aus (oder npx hyperframes skills update <name> für eine einzelne Skill). Lies /hyperframes einmal für die Projektstatus-Regeln, aber diese Skill ersetzt dessen Intake-Interview: Führe untenstehenden Intake durch und schreibe dann BRIEF.md mit workflow: general-video, damit HyperFrames-Tools sauber weitermachen. Wenn der Benutzer eine persönliche Style-Kit-Skill installiert hat (z. B. ein Motion-Graphics-Kit mit Style-Blöcken und SFX), verwende dessen Schriftarten, Style-Blöcke und Sounds.

Der Prozess

Arbeite diese Phasen der Reihe nach durch. Jede Phase hat eine Referenzdatei; lies sie, wenn du die Phase erreichst, nicht vorher.

  1. Intake (references/intake.md). Frage, was du nicht ableiten kannst: Projekt und Quellmaterial, was gezeigt werden muss, Nachricht, Zielgruppe, Länge, Plattformen, Seitenverhältnisse, Qualität, Musik, Stimme, Marke, Autonomiestufe, Liefergegenstände. Bündle Fragen (max. 4 pro Runde, empfohlene Option zuerst). Überspringe alles, was der Benutzer bereits beantwortet hat oder was ein Brief bereits angibt. Wenn der Benutzer „arbeite autonom“ oder „mach es einfach“ sagt, stelle nur blockierende Fragen (fehlendes Material, das du nicht erfassen kannst, nicht verifizierbare Behauptungen, eine Wahl, die alles verändert) und gib alle von dir gewählten Standardwerte in deiner ersten Fortschrittsnotiz an.
  2. Discovery. Lese jeden Brief, jedes Drehbuch und jeden Clip-Index, den der Benutzer hat. Untersuche jede Quelle mit ffprobe und zeitgestempelten Kontaktbögen (scripts/contact_sheet.sh), danach engere Bögen um Kandidatenmomente. Vertraue niemals Zeitstempeln in Notizen; überprüfe sie. Wenn Footage fehlt oder schwach ist, plane eine Aufnahme (references/capture.md) oder frage nach.
  3. Treatment (references/director.md, plus bei Spielen references/game-trailers.md). Schreibe die Hookline, den Spannungsbogen und eine Zeittabelle: jede Szene, jeder Schnitt mit Quelle und Bereich, jedes Wort mit dem Beat, auf den es fällt, jede Kamerabewegung, jeder SFX. Speichere es als SCRIPT_FINAL.md (Vorlage in assets/doc-templates/). Nur Fakten aus dem Material des Benutzers: Erfinde niemals Auszeichnungen, Zahlen, Daten oder Funktionen.
  4. Musik und Raster (references/sound.md). Wähle oder beschaffe den Track, überprüfe sein Tempo und seine Downbeats selbst (scripts/beat_grid.py), wähle den Datei-Offset so, dass ein Downbeat auf 0,0 fällt, und verankere Szenenwechsel an Taktlinien und Einschläge an Beats. Plane Musik-Versionen, wenn der Benutzer A/B-Tests wünscht.
  5. Bau (references/editing.md, references/kinetic-type.md, references/look.md, references/formats.md). Ein Picture Edit, aus Daten generiert: gemeinsame Szenen-Sub-Kompositionen pro Seitenverhältnis plus dünne Root-Dateien pro Musikversion. Beginne mit assets/template/ (einem getesteten Generator). Skaliere Schrift mit echten Font-Metriken (scripts/font_fit.py).
  6. Check und Look (references/qa-delivery.md). npx hyperframes lint, dann check, dann Snapshots zu Proof-Zeiten für jedes Seitenverhältnis. Betrachte die Frames selbst. Korrigiere, baue neu, betrachte erneut. Vertraue niemals dem ersten Durchgang.
  7. Mix und Master (references/sound.md). Simuliere jeden Mix offline (scripts/simmix.py), um vor dem Rendern nahe am Lautstärkeziel zu landen, rendere, mastere dann die endgültigen Dateien (scripts/master.py, Standardwert -14 LUFS, -1 dBTP, Videostream unberührt kopiert).
  8. Render-Matrix und Überprüfung (references/qa-delivery.md). Rendere jede Version × Seitenverhältnis, überprüfe jede Datei (ffprobe: Größe, fps, Dauer, Codecs; Lautstärke; Kontaktbogen; Wellenform an Musikwechseln mit scripts/audio_window.py).
  9. Lieferung. Endgültige Dateien, SCRIPT_FINAL.md, eine A/B-Notiz mit deiner Director's Pick pro Plattform, wenn es Versionen gibt, optionale Share-Kopien und GIFs (scripts/share_versions.sh, scripts/make_gif.sh). Berichte kurz: was du gebaut hast, wo, deine Wahl, was du noch verbessern würdest.

Director-Standardwerte (verwende sie, es sei denn, der Benutzer oder die Plattform sagt etwas anderes)

  • Starte mit dem stärksten Element, das du hast. Auf Store-Seiten (Steam, App Stores, itch) zeige innerhalb der ersten 2 Sekunden echtes Footage; ein schwarzer Text-Hook ist eine Social- oder Teaser-Wahl, kein Store-Standard.
  • Hook, dann Beweis, dann Eskalation, dann der Call-to-Action (CTA). Eine Idee pro Beat. Jede Szene verdient ihre Sekunden.
  • Schneide auf die Musik. Szenenwechsel auf Taktlinien, innere Schnitte und Wort-Einschläge auf Beats, der größte Moment auf einen Downbeat.
  • Kürzere Schnitte, wo du Energie möchtest, eine gehaltene Einstellung für den großen Moment, ein harter Schnitt auf Schwarz für eine Pointe.
  • Bewege die Kamera mit Absicht: Punch-Ins auf die Action, langsame Schübe auf gehaltene Einstellungen, Shake nur bei Einschlägen. Halte den Skalierungsfaktor unter der Qualitätsgrenze der Quelle (ca. 2,5× bei 1080p, weniger bei Realfilm).
  • Text ist lebendig: gestaffelte Einschläge, ein Akzentfarbwort pro Bildschirm, ein chromatischer oder Blitz-Akzent bei Einschlägen, langsames Driften während Halten. Halte Text in den mittleren 80 Prozent und außerhalb von UI-Zonen (Spiel-HUDs, Plattform-Overlays).
  • Echtes Footage, niemals nachgezeichnet. Trimme mit data-media-start + data-duration, ein <video> pro Schnitt.
  • Ein einheitliches Farb-Treatment auf allem Footage über /media-use-Behandlungen, eine subtile Vignette, kein Filmkorn (es bläht Dateien auf).
  • Sound: Musikbett plus leise, zielgerichtete SFX etwa 12 bis 18 dB unter der Musik; keine unnötigen Whooshes. Mastere auf das Plattform-Ziel.
  • Ende mit einer gestalteten Endkarte, die hält: Titel oder Logo, einzeiliger Pitch, der Call-to-Action und URL, Credits klein. Nie auf Schwarz enden, es sei denn, es wurde darum gebeten.
  • Alles läuft lokal. Verwende niemals HeyGen Cloud-Rendering, Veröffentlichungen, kostenpflichtige TTS oder irgendeinen Dienst, der die Dateien des Benutzers hochlädt oder Credits verbraucht, ohne explizite Zustimmung des Benutzers. Nimm den Bildschirm auf oder starte Dev-Server nur für eine vereinbarte Aufnahme.

Harte Regeln (jede hat schon einmal einen Render gekostet)

  • GSAP fromTo rendert seinen from-Zustand zur Build-Zeit. Blitze, chromatische Geister und Pulse müssen immediateRender: false verwenden, sonst erscheinen sie von Frame 0 in voller Stärke. Der ft()-Helper der Vorlage behandelt dies.
  • Eine Volume-Automations-Spur überschreibt data-volume. Setze die Verstärkung in die Spurwerte.
  • Der Renderer senkt den gesamten Mix, um den True Peak unter -1 dBTP zu halten, daher kommen Render leiser heraus als geplant. Simuliere vorher, mastere nach dem Rendern.
  • AAC-Padding macht einen Remux 30,1 s lang. Trimme mit -t <Dauer> beim Mastering.
  • Nur ein root-level HTML mit data-composition-id pro Projekt. Halte Versions-Roots in versions/ und kopiere die zu rendernde nach index.html.
  • Weise aufeinanderfolgenden Textzeilen eigene vertikale Zonen zu; überprüfe dies mit dem Layout-Audit und mit deinen Augen.
  • Desktop-Benachrichtigungen und Popups landen in Bildschirmaufnahmen. Schalte sie vor der Aufnahme aus und durchsuche Kontaktbögen danach.

Mehr in references/qa-delivery.md.

Dateien in dieser Skill

PfadVerwendung
references/intake.mdFragenkatalog, Standardwerte, Autonomiestufen
references/director.mdHooks, Bögen nach Videotyp, Tempo nach Länge, Kopierregeln, A/B/C-Musikstrategie
references/game-trailers.mdGame-Trailer-Typen, was zu zeigen ist, Store- und Jam-Spezifika, Aufnahmepläne
references/capture.mdFootage erstellen: Bildschirmaufnahme pro OS, skriptbasiertes Browser-Gameplay, Mobile-Emulation, Engine-Rekorder, Clip-Index
references/editing.mdSchnittrhythmus, Kameramathematik, HyperFrames-Muster für Schnitte, Punch-Ins, geteilte Bildschirme, Geräterahmen
references/kinetic-type.mdSchriftsystem, Größen, Slam-Vokabular, Sicherheitszonen
references/look.mdFarbbehandlungs-Payload, Vignette, Blitze, Glow, Endkarten
references/formats.md16:9, 9:16, 1:1, 4:5 Umbettung und Sicherheitszonen
references/sound.mdBeat-Raster, Musikversionen, SFX, Pegel, Simulation, Mastering, Überprüfung
references/platforms.mdLiefervorgaben für Steam, itch, App Stores, YouTube, TikTok, Reels, Shorts, X, LinkedIn, Messaging
references/qa-delivery.mdQA-Schleife, Render-Matrix, Dateibenennung, Dokumente, Share-Kopien, Fallstricke
scripts/contact_sheet.sh, beat_grid.py, font_fit.py, simmix.py, master.py, audio_window.py, make_gif.sh, share_versions.sh
assets/template/Getesteter Generator: kit.mjs, build.example.mjs, render-all.sh
assets/doc-templates/Vorlagen für BRIEF, CLIPS, SCRIPT_FINAL und AB_TEST

Verwandte Skills