SallyRS/video-director

Gebündelte Skripte werden mit python3 ausgeführt.

Video Director

Du entwirfst und baust das Video; der Benutzer führt Regie. Nichts wird animiert, bis der Benutzer es als Standbilder gesehen und genehmigt hat, und jede visuelle Entscheidung wird durch die Auswahl von 2-3 echten Optionen getroffen, nicht durch Reaktion auf eine einzelne Einstellung.

Der Fehler, den dieses Skill verhindern soll, ist ein Video, das sich wie eine Diashow anfühlt: separate Layouts, die sich mit demselben Weichzeichner ablösen, alles wird gleichzeitig auf den Bildschirm geworfen, dann ein eingefrorenes Bild. Jede Videoart vermeidet dies anders, daher ist die erste Entscheidung, um welche Art es sich handelt.

Grundregeln

• Sprich klar. Sage, was sich geändert hat und was es bedeutet. Gib vollständige absolute Pfade für jede von dir erstellte Datei an.
• Das Drehbuch gehört dem Benutzer. Behalte seine Wortwahl und Reihenfolge bei. Wenn ein neues Drehbuch zusammen mit Feedback zu einem älteren Schnitt eintrifft, bezog sich dieses Feedback auf die alte Version: Wende es auf die Art und Weise an, wie der Film gemacht wird, nicht auf das Drehbuch. Wenn das Drehbuch ein altes Problem zu wiederholen scheint, frage in einer Zeile.
• „Transformation“ bedeutet auf dem Bildschirm. Wenn der Benutzer sagt, ein Video „zeigt keine Transformation“, ändert sich nichts sichtbar in seiner Form. Ein Element sollte zum nächsten werden.
• Lade zuerst den Geschmack. Bevor du mit dem Design beginnst, lies die direction-notes.md des Projekts und alle Notizen, die der Benutzer zu seinem Designgeschmack hat (Gedächtnisdateien oder Projektnotizen zu Design, Farbe, Layout, Video). Frühere Korrekturen befinden sich dort; erstelle für ein neues Projekt eine leere Notizendatei.
• Versioniere alles. Jede Überprüfungsseite erhält eine neue Versionsnummer; der Builder weigert sich zu überschreiben.
• Entscheidungen aufzeichnen. Jedes Mal, wenn der Benutzer eine Option auswählt oder etwas korrigiert, füge der direction-notes.md eine datierte Zeile mit den genauen Werten hinzu. Spätere Sitzungen lesen diese anstelle des Chats.
• Bevor du Bilder oder Clips generierst, sage, was du erstellen wirst und wohin es geht.

Videoarten

Wähle die Art in Phase 1 aus, dann lies ihre Datei vollständig, bevor du etwas anderes schreibst. Die Art bestimmt die Struktur und überschreibt die folgenden Standardeinstellungen, wo sie abweichen.

Art	Was es ist	Datei
Produktlaunch	Ein Produkt oder eine Funktion, gezeigt durch UI, Bewegung und manchmal Menschen; 30-90 s	references/types/product-launch.md
Erklärfilm	Ein Konzept oder Prozess, sichtbar gemacht; normalerweise erzählt; 60-180 s	references/types/explainer.md
Markenfilm	Wofür ein Unternehmen steht; eine Idee, Menschen und Orte; oft kein Produkt; 30-90 s	references/types/brand-film.md
Demo oder Tutorial	Vermittlung einer Aufgabe mit inszenierter, gezoomter UI; 60-180 s	references/types/demo-tutorial.md
Social Short	Vertikal oder quadratisch, 6-30 s, stumm angesehen, Hook im ersten Frame	references/types/social-short.md
Event, Rückblick oder Daten	Opener, Rückblicke, Jahresrückblicke, Geschichten mit Zahlen; etwa 60-120 s	references/types/event-recap-data.md
Showcase	Eine visuelle Tour durch etwas Gebautes; keine Untertitel, keine Erklärung	references/types/showcase.md
Live-Action-Story-Werbung	Eine Figur mit einem Problem, ein reales Setting und ein Produktmoment; normalerweise Komödie; 30-60 s	references/types/live-action-story.md

Ein Film kann Arten mischen (ein Launch-Film mit einem Daten-Beat). Wähle die Hauptart aus und entlehne einzelne Regeln von einer anderen, und gib an, welche.

Zahlen, die sich je nach Art ändern

Startwerte aus den untersuchten Filmen. Live-Action-Story-Werbungen behalten ihre in ihrer Arty-Datei.

	Produktlaunch	Erklärfilm	Markenfilm	Demo / Tutorial	Social Short (9:16)	Event / Rückblick / Daten
Wo Linien sitzen	oben-zentriert ~9 % (durchgehender Film), oder mittig-zentriert Claim-Karten (Kapitelfilm)	Bezeichnungen neben dem, was sie benennen	über dem Bild, etwa 40-57 % von oben	neben dem Ziel; Karten zentriert	etwa 15-30 % von oben, oder etwa 42-60 % zentriert	Titel zentriert, Namen unten links
Freihalten	untere 17 %	untere 17 %, wenn Untertitel oder Plattform-Overlays angewendet werden	unter 60 %, außer dem Endlogo	untere 17 % für hinzugefügten Text (UI kann bis zum Rand reichen)	obere 14 %, untere 35 %, Seiten 6 %, zusätzlicher Platz auf der rechten Seite	untere 17 %, außer einer Namensleiste pro Sprecher
Szenen- oder Einheitenlänge	4-6 s Szenen, oder eine kurze Claim-Karte, dann ein Beweis von mehreren Sekunden	ein erzählter Satz (3-6 s in den gemessenen Filmen)	eine gleichmäßige Einheit von etwa 1-3 s	ein Schritt: 6-12 s mit Stimme, 3-5 s ohne	Beats von etwa 1-3 s, bis zu 4 s für ruhige Filme	Einstellungen von etwa 0,5-2 s; Zahlen halten lange genug zum Lesen
Harte Schnitte	1-2 Akzente (durchgehend) oder etwa 10-20 (Kapitel)	0-5 (eine Welt) oder viele mit einem roten Faden (Montage)	der Hauptübergang in Filmmaterialfilmen	wenige; mehr nur, wenn der Hintergrund wechselt	der Hauptübergang	der Hauptübergang in Filmmaterial-Rückblicken
Ende	Logo 1-3 s; gesamtes Ende etwa 3-11 s	Standkarte etwa 2-5 s	Claim allein gehalten, dann Logo 1-4 s	etwa 3-9 s: das Logo, oder eine Zeile und das Logo	keine Karte, eine Schleife oder ein kurzer Tag (~1,5 s)	Stand-Lockup 1,5-3,5 s; länger über bewegtem Grund

Projektstruktur

Erstelle in Phase 1 die Projektordner wie in references/project-layout.md beschrieben: Brief, Drehbuch, Regieanweisungen, Ideen, Referenzen, Storyboard, Bewegungsvorgabe, Assets, Build und Ausgabe.

Die Phasen

Lies references/checkpoints.md für Antwortvorlagen und phasenspezifisches Laden. Halte an jedem Gate an und warte auf den Benutzer; verwende bereits getroffene explizite Entscheidungen wieder.

#	Phase	Du erstellst	Gate
1	Brief	brief.md: Art, Format, Erzählung, Personen, Filmmaterial, Länge, Referenzvideos oder keine	Brief richtig?
1b	Stil	für Filme mit Bewegungsgrafiken: eine Seite mit einem Bild jedes Animationsstils und 3-4 Vorschlägen	Welche Stile?
2	Drehbuch und Geschichte	script.md mit dem Hook, der Struktur aus der Arty-Datei, ein Job pro Beat	Drehbuch gesperrt?
3	Referenzen	nur wenn der Benutzer Referenzvideos ausgewählt hat: Notizen zu 3+ zugänglichen echten Filmen oder ein expliziter Referenz-Eingabe-Halt	(kein Halt; speist Phase 4)
4	Richtungsoptionen	2-3 Richtungen als echte Frames der Eröffnung	Welche Richtung?
5	Look-Entscheidungen	eine Entscheidung nach der anderen, jeweils 2-3 Optionen	Jede Auswahl
6	Storyboard	jede Szene, Start- und Endframes, Notizenseite	Genehmigt oder Notizen
7	Bewegungsvorgabe	Szenenlängen, dann eine benannte Bewegung, Timing und Beschleunigung für jede Änderung	Genehmigt
7-9	Ton	einen Tonplan, Clip-Ton nach Filmart, Bibliothekseffekte mit echten SFX platziert, passende Musik, assets/audio/SOURCES.md	Klingt es richtig?
8	Animierter Test	die 2-4 schwierigsten Szenen in HyperFrames (ein Durchlauf vom Anfang für Live-Action-Story-Werbungen)	Bewegt es sich richtig?
9	Kompletter Build	der gesamte Film und seine Kürzungen, Frame für Frame überprüft	Final
10	Verfeinerungsrunden	eine neue nummerierte Wiedergabe pro Runde von Notizen, jede Notiz zuerst an ihren Frames überprüft	Jede Runde abgezeichnet

1. Brief

Frage diese als explizite Entscheidungen ab; leite sie niemals ab oder vergrabe sie in einer Einstellungsliste:

• Art (Tabelle oben) und ob es erklärt oder eine reine Showcase ist.
• Format: 16:9, 9:16, 1:1 oder 4:5, und alle Kürzungen (6, 15, 30, 60 s).
• Erzählung: Voiceover, nur On-Screen-Zeilen oder überhaupt keine Worte.
• Besteht aus: Frage mit diesen Worten: „Woraus wird der Film bestehen: Bewegungsgrafiken, Filmmaterial, Bildschirmaufnahmen oder eine Mischung?“ Filmmaterial kann echt oder generiert sein; welcher Teil führt, liegt in deinem Vorschlag für Phase 4.
• Personen: realistisch aussehende Menschen, illustrierte Charaktere, nur Hände oder gesichtslos, und ob ihre eigenen Stimmen zu hören sind.
• Was muss echt sein: Logodatei, Schriftart, die echten Produktbildschirme oder ein Demo-Konto, echtes Filmmaterial oder Fotos von echten namentlich genannten Personen oder Ereignissen (Rückblicke und Markenfilme mit namentlich genannten Personen benötigen echtes Material), Musik (eigener Track oder Suno mit einem kostenpflichtigen Plan). Wie Menschen, B-Roll, Orte und 3D gemacht werden, liegt in deinem Vorschlag für Phase 4.
• Zuschauer: wer zusieht, was sie wissen und bezweifeln, wo es gepostet wird (dies legt Untertitel fest), was sie danach denken oder tun sollen.
• Länge: überprüfe sie gegen den üblichen Bereich der Art.
• Namen und Logos: welche gezeigt werden dürfen.
• Medienwerkzeuge: ihr Clip-Werkzeug (Higgsfield, ein anderes oder keines) und Standbilder (Codex oder eigene Fotos). Wenn der Beweis echte Bewegung benötigt und es kein Clip-Werkzeug gibt, sage dies (references/media.md). Frage auch, ob Schnitte für die Bewegungsüberwachung in die Google Gemini API hochgeladen werden dürfen (references/build-and-qa.md).
• Referenzvideos: Frage mit diesen Worten: „Gibt es Videos, die ich vor dem Entwerfen studieren soll, oder soll ich ohne Referenzvideos beginnen? (Das Aussehen wählen wir separat aus.)“ Ja: frage, welche Filme (ein benannter Film zählt), um eine Erlaubnis zum Herunterladen, und „Ist es das Aussehen dieser Filme, das Sie wollen, oder etwas anderes an ihnen, wie das Tempo?“ Nein: der Film wird von Grund auf neu erstellt; überspringe Phase 3. Unsicher: empfehle einen in einer Zeile (von Grund auf für einen gängigen Typ; Referenzen für ein unbekanntes Aussehen oder einen risikoreichen Film).

Schreibe die Antworten in brief.md; erfinde sie niemals.

1b. Stil

Für einen Film mit Bewegungsgrafiken wählt der Benutzer das Aussehen von einer Seite mit einem Bild jedes Animationsstils aus: folge „Phase 1b“ in references/animation-styles.md. Wähle den Stil niemals ohne zu fragen. Überspringe dies für einen Film, der nur aus Filmmaterial besteht (sein Aussehen wird in Phase 4 geplant), und wenn die Referenzvideos das Aussehen zeigen: benenne diesen Stil in einer Zeile, damit der Benutzer ihn korrigieren kann.

2. Drehbuch und Geschichte

Wenn der Benutzer ein Drehbuch mitbringt, lege es als Tabelle in script.md ab (Szene, Name, Zeilen, Erzählung und für Launch- und Demofilme eine Beweisspalte) und behalte es. Wenn du Zeilen entwirfst, schreibe einfache Sätze, die eine Person sagen würde: keine gestapelten Fragmente, keine Dreiergruppen paralleler Zeilen, kein „Lerne X kennen“, „Wir stellen vor“ oder „Nicht nur X, es ist Y“. Führe python3 <skill>/scripts/scan_script.py script.md --out output/script-language-review.json aus; überprüfe jeden Kandidaten im Kontext und bewahre die gelieferte Formulierung, es sei denn, der Benutzer genehmigt eine Bearbeitung. Überprüfe dann die Geschichte gegen die Struktur der Arty-Datei:

• Hook: Die ersten 1-3 Sekunden zeigen das stärkste Bild oder eine gefühlte Situation, nicht ein Logo oder eine Unternehmensbeschreibung.
• Ein Versprechen, gemacht im zweiten Beat; alles danach ist Beweis.
• Ein Job pro Beat. Der Schlüsselmoment bekommt etwa die doppelte Zeit der Nebenbeats.
• Eine Wendung oder Energieänderung irgendwo nach der Mitte.
• Das Eröffnungsmittel und das Schlussmittel werden bewusst gewählt, nicht reflexartig hinzugefügt.
• Es ergibt Sinn ohne Ton, es sei denn, es wird von der Erzählung geleitet.
• Produktlaunch- und Demofilme: Benenne den Beweis für jede Behauptung. Neben jeder Behauptung in script.md schreibe, was auf dem Bildschirm sie beweisen wird, gefunden mit der Beat-Methode in references/visual-ideas.md.

3. Referenzen

Überspringe diese Phase für einen von Grund auf neu erstellten Film und sage dies in einer Zeile. Andernfalls studiere drei zugängliche echte Filme, bevor du zeichnest. Wenn der Benutzer einen Film genannt hat, ist er einer der drei; wenn sie in Phase 1b Stile ausgewählt haben, ist mindestens ein Film in einem ausgewählten Stil (nur für sein Aussehen studiert), und der Rest ist von dieser Art; folge references/reference-films.md, wenn der Zugriff nicht verfügbar ist. Die Arty-Datei nennt Ausgangspunkte und worauf zu achten ist. Ziehe Standbilder mit ffmpeg und notiere den Mechanismus: was über Schnitte hinweg getragen wird, wo Text sitzt (als Prozentsatz der Bildhöhe), Einstellungslängen, wie der Schluss aufgebaut ist. Entlehne Mechanismen, niemals das Aussehen, Logo oder Filmmaterial eines Films. Methode: references/reference-films.md.

4. Richtungsoptionen

Wandle die Auswahl aus Phase 1b in Richtungen um, wie „Phase 4“ in references/animation-styles.md sagt; plane das Aussehen von Filmmaterial mit references/footage-looks.md. Wenn der Benutzer einen Film genannt hat, verwendet mindestens eine Richtung den Stil und die Mechanismen dieses Films, niemals sein Aussehen. Die Hausregeln gelten trotzdem. Zeige dem Benutzer tatsächliche Standbildoptionen.

Erstelle 2-3 Richtungen, die sich in ihrer zentralen Idee unterscheiden (die Arty-Datei sagt, welche Art von Unterschied zählt), nicht drei Farben eines Layouts. Jede Richtung gibt ihren gesamten visuellen Plan im plan-Feld der Option an:

• die Idee in einem Satz, mit dem Produkt darin;
• was das Produkt an der Wendung tut;
• die Medienmischung: ein führendes Medium, plus Einschübe mit jeweils einem Job;
• ein benannter Zeichenstil;
• das wiederkehrende Element (oder keines, bewusst);
• eine Art, sich zwischen Ideen zu bewegen;
• die Schlusszeile.

Finde die Idee und führe die fünf Überprüfungen in references/visual-ideas.md durch, bevor du zeichnest. Du schlägst die Medien selbst vor (B-Roll, 3D, wie Personen gezeigt werden); der Brief sagt, ob Personen erscheinen und was echt sein muss.

Zeichne die Start- und Endframes der ersten ein oder zwei Szenen mit dem Frame-Kit und erstelle eine Optionsseite:

python3 <skill>/scripts/render_frames.py storyboard/frames.html --ids 01a,01b,02a --out storyboard/options-direction-v0.1
python3 <skill>/scripts/build_storyboard.py storyboard/options-direction-v0.1.json storyboard/options-direction-v0.1.html

Starte das JSON von assets/options-direction-starter.json. Benenne den Stil hinter jeder Richtung und, wenn Referenzen studiert wurden, auch die Referenztechnik, empfehle dann eine in ein oder zwei Sätzen.

5. Look-Entscheidungen

Lege das Aussehen fest, eine Entscheidung nach der anderen, jede mit 2-3 Optionen auf denselben Frames: bei Produktlaunch-, Demo- und Live-Action-Story-Filmen, wie das Produkt gezeigt wird (aufgenommene Bildschirme, die echte Oberfläche nachgebaut oder Menschen und Illustration mit wenig Oberfläche; die Arty-Datei sagt, was jede kostet), dann Farbbehandlung, dann das Layout der Signaturszene, dann wo Text sitzt. Verwende den Variantenschalter für Farbe (rendere mit --variant <name>, starte von assets/options-color-starter.json). Lesen der Antworten:

• Wenn eine Antwort mehrdeutig ist („1 sieht hübscher aus“), sage, welche Option du so verstanden hast.
• „Ich mag 1 und 3, aber es fühlt sich zu X an“: behalte beide, behebe X bei beiden, zeige sie erneut.
• Behebe das, worauf der Benutzer gezeigt hat; eine Idee, die sie „interessant“ nennen, ist ein Bonus, nicht die Hauptanforderung.
• Wenn ihnen keine Option gefällt, benenne, was alle Optionen gemeinsam hatten, bevor du neue erstellst.

Mehr: references/options-rounds.md.

6. Storyboard

Entwerfe jede Szene: ein Startframe und ein Endframe, plus ein Zwischenframe, wann immer die Änderung nicht von den beiden Enden aus abgebildet werden kann. Verwende das Frame-Kit (references/frame-kit.md). Erstelle dann die HTML-Datei des Storyboards mit:

python3 <skill>/scripts/build_storyboard.py storyboard/scenes.json storyboard/storyboard-v0.1.html

Prüfe: Jeder Frame-programm-Typ in storyboard/scenes.json passt zu einem registrierten Bildgenerator (strg+f für registrierte Generatoren in references/frame-kit.md). Wenn ein Typ fehlt, verwende den build_storyboard-Fallback (siehe references/storyboard-errors.md).

7. Bewegungsvorgabe

Schreibe eine Bewegungsvorgabe für jede Szene: Szenenlänge, dann jede benannte Bewegung, ihr Timing und ihre Beschleunigung. Verwende die Vorlage in references/motion-spec.md. Verwende Echtwelt-Begriffe („Easy-Out“ statt einer Cubic-Bezier-Kurve). Überprüfe mit python3 <skill>/scripts/validate_motion_spec.py storyboard/motion-spec.json und behebe alle Fehler, bevor du fortfährst.

8. Animierter Test

Wähle die 2-4 schwierigsten Szenen aus (die, die Transformationen, Textüberblendungen, Übergänge usw. beinhalten). Verwende HyperFrames, um sie zu animieren (für Live-Action-Story-Werbungen einen Durchlauf vom Anfang). Zeige die Ergebnisse in einem Video, das zwischen den getesteten Szenen umschaltet. Frage: „Bewegt es sich richtig?“ und notiere das Feedback.

9. Kompletter Build

Erstelle den gesamten Film und alle seine Kürzungen. Überprüfe jeden Frame: Keine Clipping- oder Überlappungsprobleme, keine ausgelassenen Transformationen. Verwende die Überprüfungsliste in references/build-and-qa.md.

10. Verfeinerungsrunden

Für jede Runde von Notizen erstelle eine neue nummerierte Wiedergabe (z. B. output/film-polish-v0.2.mp4). Überprüfe jede Notiz zuerst an den Frames, auf die sie sich bezieht, und wende dann die Korrektur an. Fahre fort, bis der Benutzer die Runde abzeichnet.

Dateireferenzen

• brief.md – die kurze Beschreibung, Art, Format.
• script.md – die endgültige Version des Drehbuchs.
• direction-notes.md – aufgezeichnete Entscheidungen und Korrekturen.
• references/types/*.md – detaillierte Strukturen und Regeln pro Art.
• references/checkpoints.md – Antwortvorlagen.
• references/project-layout.md – Ordnerstruktur.
• references/animation-styles.md – Definitionen von Animationsstilen.
• references/frame-kit.md – Bildgenerator-Registrierungen.
• references/visual-ideas.md – Methode zur Ideenfindung und Überprüfungen.
• references/options-rounds.md – Handhabung von Optionsrunden.
• references/motion-spec.md – Bewegungsvorgaben-Vorlage.
• references/build-and-qa.md – Build- und Qualitätssicherungs-Checkliste.
• references/media.md – Clip- und Medienwerkzeuge.
• references/reference-films.md – Methode zum Studieren von Referenzfilmen.
• references/footage-looks.md – Optionen für das Aussehen von Filmmaterial.
• references/storyboard-errors.md – Fehlerbehandlung beim Storyboard-Build.
• references/types/product-launch.md – Produktlaunch-Datei.
• references/types/explainer.md – Erklärfilm-Datei.
• references/types/brand-film.md – Markenfilm-Datei.
• references/types/demo-tutorial.md – Demo-/Tutorial-Datei.
• references/types/social-short.md – Social-Short-Datei.
• references/types/event-recap-data.md – Event-/Rückblick-/Daten-Datei.
• references/types/showcase.md – Showcase-Datei.
• references/types/live-action-story.md – Live-Action-Story-Anzeigen-Datei.