Was macht Video Script Writer?
Schreibt Videodrehbücher für Produktdemos, Feature-Walkthroughs und Launch-Videos. Behandelt Rhythmus, visuelle Anweisungen, Timing und plattformgerechte Längen.
Eingabeauflösung
Das Argument (sofern angegeben) in dieser Reihenfolge auflösen:
- Pfad zu einem vorhandenen Marketing-Briefing (
.mdmit "Executive Summary" oder "Key Messages") -> Marketing-Briefing - Pfad zu einem vorhandenen Blogbeitrag (
.mdmit Blogbeitragsstruktur) -> Blogbeitrag - Pfad zu einem vorhandenen Changelog -> Changelog
- Pfad zu einem vorhandenen Newsletter -> Newsletter
- Entspricht einer GitHub-URL oder einem
#\d+-Muster -> PR - Enthält
...oder..-> Git-Referenzbereich - Löst sich in eine vorhandene Datei/ein vorhandenes Verzeichnis auf -> Codebase-Feature
- Andernfalls -> Freitext
Wenn kein Argument angegeben wird, frage: "Worum soll es im Video gehen? Du kannst ein Marketing-Briefing, einen Blogbeitrag, einen Changelog, eine PR-URL/-Nummer, einen Git-Referenzbereich, einen Datei-/Verzeichnispfad angeben oder das Feature einfach beschreiben."
Wenn mehrere Interpretationen zutreffen, mit dem Benutzer abklären.
Prozessablauf
digraph video_script {
rankdir=TB;
"Eingabe auflösen" [shape=box];
"Phase 1: Entdeckung" [shape=box];
"Phase 2: Konfiguration" [shape=box];
"Phase 3: Gliederung" [shape=box];
"Gliederung genehmigt?" [shape=diamond];
"Phase 4: Schreiben" [shape=box];
"Phase 5: Überprüfung" [shape=box];
"Genehmigt?" [shape=diamond];
"Phase 6: Ausgabe" [shape=box];
"Eingabe auflösen" -> "Phase 1: Entdeckung";
"Phase 1: Entdeckung" -> "Phase 2: Konfiguration";
"Phase 2: Konfiguration" -> "Phase 3: Gliederung";
"Phase 3: Gliederung" -> "Gliederung genehmigt?";
"Gliederung genehmigt?" -> "Phase 3: Gliederung" [label="nein, überarbeiten"];
"Gliederung genehmigt?" -> "Phase 4: Schreiben" [label="ja"];
"Phase 4: Schreiben" -> "Phase 5: Überprüfung";
"Phase 5: Überprüfung" -> "Genehmigt?";
"Genehmigt?" -> "Phase 4: Schreiben" [label="Überarbeitungen"];
"Genehmigt?" -> "Phase 6: Ausgabe" [label="ja"];
}
NIEMALS Phasen überspringen. Fragen in natürlichem Tempo stellen. Wenn der Benutzer mehrere auf einmal beantwortet, gebündelte Antworten akzeptieren und überspringen.
Wenn der Benutzer sagt "wähle einfach Standardeinstellungen" oder ähnlich, vernünftige Standardwerte wählen, mitteilen was gewählt wurde und um eine einzige Bestätigung bitten.
Phase 1: Entdeckung
Schritt 1 - Eingabe analysieren
| Eingabetyp | Was gelesen werden soll |
|---|---|
| Marketing-Briefing | Problemstellung, Wertversprechen, Zielgruppe, Kernbotschaften extrahieren. Zu Schritt 3 springen. Schritt 2 trotzdem durchführen, wenn dem Briefing der Produktkontext fehlt. |
| Blogbeitrag | Überschrift, Kernpunkte, Zielgruppe, CTA extrahieren. Zu Schritt 3 springen. |
| Changelog | Wichtige Einträge extrahieren, Fokus auf die wirkungsvollsten Änderungen. Zu Schritt 3 springen. |
| Newsletter | Betreff, wichtige Updates, CTA extrahieren. Zu Schritt 3 springen. |
| PR | Diff, PR-Beschreibung, Review-Kommentare, Commit-Nachrichten. Bei großen PRs (20+ Dateien) Fokus auf benutzerseitige Änderungen. |
| Git-Referenzen | git diff und git log zwischen den Referenzen. Benutzerseitige Änderungen priorisieren. |
| Codebase-Feature | Die angegebenen Dateien/Verzeichnisse lesen. |
| Freitext | Die Beschreibung des Benutzers analysieren. Wenn es an Details fehlt, den Benutzer bitten, mehr Details zu liefern oder auf eine bestimmte Datei/PR zu verweisen. |
Benutzerseitige Änderungen umfassen: neue Funktionen, UI-Änderungen, API-Änderungen, Leistungsverbesserungen, Fehlerbehebungen und Dokumentationsaktualisierungen. Interne Änderungen umfassen: Refactorings, Tests, CI-Änderungen und Abhängigkeitsaktualisierungen.
Fehlerbehandlung:
ghnicht verfügbar -> Benutzer informieren, alternative Eingabe anbieten- Ungültige PR/Referenz -> Benutzer bitten zu überprüfen
- Datei nicht gefunden -> Nach korrektem Pfad fragen
Schritt 2 - Weiteren Produktkontext lesen
Lesen, falls vorhanden: README, docs/, package.json (oder Äquivalent).
Wenn nichts gefunden wird, fragen: "Kannst du das Produkt kurz beschreiben und für wen es gedacht ist?"
Schritt 3 - Verständnis präsentieren
"Folgendes wird die Grundlage des Videodrehbuchs sein:"
- Funktion A - kurze Beschreibung
- Funktion B - kurze Beschreibung
"Möchtest du etwas hinzufügen, entfernen oder korrigieren?"
NICHT fortfahren, bis der Benutzer den Umfang bestätigt.
Schritt 4 - Prüfung auf sensible Inhalte
Vor dem Fortfahren auf potenziell sensible Inhalte prüfen: Sicherheitspatches, interne Preise, Anmeldeinformationen, nicht veröffentlichte Roadmap-Elemente oder als vertraulich gekennzeichnete Inhalte. Alles Fragwürdige dem Benutzer melden.
Phase 2: Konfiguration
Diese Fragen stellen:
F1 - Videolänge:
- Kurzform (30-90 Sekunden) - soziale Medien (Reels, Shorts, TikTok)
- Mittelform (3-5 Minuten) - YouTube, Produktdemos, Walkthroughs
F2 - Skripttyp:
- Voiceover - Erzähltext, der über Bildschirmaufnahmen/Filmmaterial gelesen wird
- Zwei-Spalten - linke Spalte: visuelle Anweisungen/Bildschirmaktionen, rechte Spalte: Erzählung
- Talking-Head - Sprecher vor der Kamera, dialogorientierte Vortragsweise
F3 - Ton: Vorhandene Repository-Inhalte lesen, um die Stimme zu erkennen. Bestätigen:
"Basierend auf deinen vorhandenen Inhalten scheint der Ton [z.B. dialogorientiert und entwicklerfreundlich] zu sein. Soll ich mich daran orientieren oder einen anderen Weg gehen?"
Wenn keine Inhalte zur Analyse vorhanden sind, direkt fragen.
F4 - CTA: Aus dem Kontext ableiten:
- Open Source -> "Repository mit einem Stern versehen", "Ausprobieren"
- SaaS -> "Kostenlos anmelden", "Testversion starten"
- Funktionsupdate -> "Jetzt ausprobieren", "Dokumentation prüfen"
"Ich würde den CTA wie folgt vorschlagen: [abgeleiteter CTA]. Möchtest du dabei bleiben oder etwas anderes?"
Phase 3: Gliederung
Eine strukturierte Gliederung mit Zeitangaben erstellen. Die entsprechende Vorlage basierend auf der Videolänge verwenden:
Kurzform (30-90 Sekunden) - 3-4 Abschnitte:
## [Arbeitstitel] - [Gesamtdauer]
1. **Hook** (0:00-0:05) - [Ansatz]
- Kernpunkt
- Visuell: [was gezeigt wird]
2. **Problem** (0:05-0:15) - [zu etablierender Schmerzpunkt]
- Visuell: [was gezeigt wird]
3. **Lösung** (0:15-0:45) - [Feature-Walkthrough]
- Kernpunkt A
- Visuell: [was gezeigt wird]
- Kernpunkt B
- Visuell: [was gezeigt wird]
4. **CTA** (0:45-0:60) - [durchzuführende Aktion]
- Visuell: [Endbild]
Geschätzte Gesamtwörter: ~X Wörter (~Y Sekunden bei 135 WPM)
Mittelform (3-5 Minuten) - 5-8 Abschnitte:
## [Arbeitstitel] - [Gesamtdauer]
1. **Hook** (0:00-0:10) - [Ansatz]
- Visuell: [was gezeigt wird]
2. **Problem** (0:10-0:30) - [Schmerzpunkt, Kontext, warum das wichtig ist]
- Visuell: [was gezeigt wird]
3. **Lösungsüberblick** (0:30-1:00) - [allgemeine Beschreibung des Gebauten]
- Visuell: [was gezeigt wird]
4. **Tiefergehend: [Funktion A]** (1:00-2:00) - [Walkthrough]
- Kernpunkte
- Visuell: [Bildschirmaufzeichnungsschritte]
5. **Tiefergehend: [Funktion B]** (2:00-3:00) - [Walkthrough]
- Kernpunkte
- Visuell: [Bildschirmaufzeichnungsschritte]
6. **Tiefergehend: [Funktion C]** (3:00-3:45) - [Walkthrough]
- Kernpunkte
- Visuell: [Bildschirmaufzeichnungsschritte]
7. **Zusammenfassung** (3:45-4:30) - [wichtigste Vorteile zusammenfassen]
- Visuell: [Zusammenfassungsfolie oder Nebeneinander]
8. **CTA** (4:30-5:00) - [durchzuführende Aktion]
- Visuell: [Endbild]
Geschätzte Gesamtwörter: ~X Wörter (~Y Sekunden bei 135 WPM)
Die Anzahl der tiefergehenden Abschnitte an die abgedeckten Funktionen anpassen.
Die Gliederung präsentieren und vor dem Schreiben auf Genehmigung warten.
Phase 4: Schreiben
Rhythmus-Referenz
| Videolänge | Zielwörter | WPM |
|---|---|---|
| 30 Sekunden | ~65 Wörter | 130 |
| 60 Sekunden | ~135 Wörter | 135 |
| 90 Sekunden | ~200 Wörter | 135 |
| 3 Minuten | ~400 Wörter | 135 |
| 5 Minuten | ~675 Wörter | 135 |
Ziel: 130-145 WPM für dialogorientierte Vortragsweise. Jeden Abschnitt markieren, der seine zugewiesene Zeit überschreitet.
Skriptformat nach Typ
Voiceover-Skript:
## [Titel]
### Hook (0:00-0:05) - ~15 Wörter
VISUELL: [Beschreibung dessen, was auf dem Bildschirm zu sehen ist]
[Erzähltext hier.]
### Abschnittsname (0:05-0:20) - ~30 Wörter
VISUELL: [Beschreibung dessen, was auf dem Bildschirm zu sehen ist]
[Erzähltext hier.]
Zwei-Spalten-Skript:
| Zeit | Visuell | Erzählung |
|---|---|---|
| 0:00-0:05 | [Bildschirm: Landingpage lädt] | [Erzähltext] |
| 0:05-0:15 | [Bildschirm: Menü „Einstellungen" klicken] | [Erzähltext] |
| 0:15-0:30 | [Bildschirm: Dunkelmodus umschalten] | [Erzähltext] |
Talking-Head-Skript:
## [Titel]
### Hook (0:00-0:05) - ~15 Wörter
KAMERA: [Sprecher vor der Kamera, mittlere Einstellung]
[Sprechertext hier. Dialogorientiert, direkt in die Kamera.]
### Abschnittsname (0:05-0:20) - ~30 Wörter
KAMERA: [Schnitt zur Bildschirmaufzeichnung]
VOICEOVER: [Erzählung über Bildschirmaufzeichnung]
KAMERA: [Zurück zum Sprecher]
[Sprechertext hier.]
Hook
Die ersten 3-5 Sekunden entscheiden darüber, ob Zuschauer weiterzuschauen. Der Hook muss:
- Einen Schmerzpunkt ansprechen oder eine provokative Frage stellen
- NICHT mit dem Namen Ihres Unternehmens/Produkts beginnen
- NICHT mit "In diesem Video zeige ich dir..." beginnen
- Sofort Neugier oder emotionale Resonanz erzeugen
Visuelle Anweisungen
Immer visuelle Anweisungen inline einfügen, unabhängig vom Skripttyp:
VISUELL:/BILDSCHIRM:für Bildschirmaufnahmen und FilmmaterialKAMERA:für Kameraregie beim Talking-Head- Spezifisch sein: "BILDSCHIRM: Auf den Export-Button klicken, PDF-Download zeigen" nicht "BILDSCHIRM: Funktion zeigen"
- Übergangsnotizen zwischen den Szenen einfügen
Zeitangaben pro Abschnitt
Geschätzte Dauer und Wortanzahl für jeden Abschnitt angeben:
### Abschnittsname (0:15-0:30) - ~30 Wörter- Markieren, wenn ein Abschnitt sein Zeitbudget überschreitet
- Die Gesamtwortanzahl des Skripts muss der Zieldauer bei 135 WPM entsprechen
Schreibregeln
- Dialogorientiert, nicht wie ein Skript geschrieben klingen. Schreiben wie Menschen tatsächlich sprechen.
- Kurze Sätze. Maximal 10-15 Wörter pro Satz.
- Eine Idee pro Satz.
- Immer Aktiv verwenden.
- NIEMALS Gedankenstriche im generierten Inhalt verwenden. Keine "---"-Zeichen. Stattdessen Kommas, Doppelpunkte, Punkte oder Klammern verwenden.
- Zeigen, nicht erzählen. "Sieh zu, wie schnell das lädt" > "Es lädt sehr schnell"
- Bei Videos in mittlerer Länge die Dreierregel anwenden: drei Vorteile, drei Funktionen, drei Beispiele. Bei Kurzform auf einen einzigen Hauptvorteil konzentrieren.
CTA
- Letzte 5-10 Sekunden des Videos
- Einzelne, klare Aktion
- Visuelle Anweisung für das Endbild einfügen (Abonnement-Button, Link-Overlay, QR-Code)
Phase 5: Überprüfung
Das vollständige Skript mit Zeitaufschlüsselung präsentieren:
"Hier ist das Skript:"
[Vollständiges Skript]
Zeitaufschlüsselung:
- Hook: 5s (~15 Wörter)
- Problem: 10s (~25 Wörter)
- Lösung: 30s (~70 Wörter)
- CTA: 10s (~20 Wörter)
- Gesamt: 55s (~130 Wörter bei 135 WPM)
"Möchtest du Änderungen?"
Auf Genehmigung warten. Nur zur Ausgabe übergehen, sobald der Benutzer bestätigt.
Phase 6: Ausgabe
Das endgültig genehmigte Skript immer im Terminal ausgeben.
Dann fragen: "Soll ich das unter scripts/<slug>.md speichern? Oder einem anderen Pfad?"
Das Verzeichnis erstellen, falls es nicht existiert. Wenn die Datei bereits existiert, fragen, ob überschrieben oder eine versionierte Kopie erstellt werden soll.
Fehlerbehandlung
ghnicht verfügbar -> Benutzer informieren, alternative Eingabe anbieten- Ungültige PR/Referenz -> Benutzer bitten zu überprüfen
- Kein Produktkontext -> Benutzer bitten, das Produkt zu beschreiben
- Skript überschreitet Zieldauer -> vor der Überprüfung markieren und Kürzungen vorschlagen
Was diese Fähigkeit NICHT tut
- Video aufnehmen oder bearbeiten
- Thumbnails oder visuelle Assets generieren
- Animationen oder Bewegungsgrafiken erstellen
- Blogbeiträge oder Social-Media-Texte schreiben (
/blog-postoder/social-copyverwenden)