Communitygithub.com

Video Script Writer

Erstellt professionelle Videodrehbücher für Produktdemos, Feature-Walkthroughs und Launch-Videos, mit Timing, visuellen Anweisungen und plattformgerechten Längen.

Was ist Video Script Writer?

Diese Fähigkeit erstellt automatisch Videodrehbücher für Produktdemos, Feature-Walkthroughs, Launch-Videos und Social-Media-Videos. Sie analysiert verschiedene Eingabeformate wie Marketing-Briefings, Blogbeiträge, Changelogs, Newsletters, Pull-Requests oder Codebase-Features und leitet daraus eine klare Struktur ab. Der gesamte Prozess ist in sechs Phasen unterteilt: Eingabeanalyse, Konfiguration (Länge, Skripttyp, Ton, CTA), Erstellung einer Gliederung, Schreiben des Skripts, Überprüfung und finale Ausgabe. Die Fähigkeit unterstützt drei Skripttypen (Voiceover, Zwei-Spalten, Talking-Head) und bietet für Kurz- und Langformate passende Vorlagen. Sie legt großen Wert auf Timing (Wörter pro Minute), visuelle Anweisungen und einen natürlichen, dialogorientierten Schreibstil. Die Fähigkeit ist für CI/CD-Umgebungen optimiert und arbeitet plattformunabhängig. Sie eignet sich besonders für Entwicklerteams, die regelmäßig Produktupdates und neue Features in klaren, handlungsorientierten Videos präsentieren möchten.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

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:

  1. Pfad zu einem vorhandenen Marketing-Briefing (.md mit "Executive Summary" oder "Key Messages") -> Marketing-Briefing
  2. Pfad zu einem vorhandenen Blogbeitrag (.md mit Blogbeitragsstruktur) -> Blogbeitrag
  3. Pfad zu einem vorhandenen Changelog -> Changelog
  4. Pfad zu einem vorhandenen Newsletter -> Newsletter
  5. Entspricht einer GitHub-URL oder einem #\d+-Muster -> PR
  6. Enthält ... oder .. -> Git-Referenzbereich
  7. Löst sich in eine vorhandene Datei/ein vorhandenes Verzeichnis auf -> Codebase-Feature
  8. 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

EingabetypWas gelesen werden soll
Marketing-BriefingProblemstellung, 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.
ChangelogWichtige Einträge extrahieren, Fokus auf die wirkungsvollsten Änderungen. Zu Schritt 3 springen.
NewsletterBetreff, wichtige Updates, CTA extrahieren. Zu Schritt 3 springen.
PRDiff, PR-Beschreibung, Review-Kommentare, Commit-Nachrichten. Bei großen PRs (20+ Dateien) Fokus auf benutzerseitige Änderungen.
Git-Referenzengit diff und git log zwischen den Referenzen. Benutzerseitige Änderungen priorisieren.
Codebase-FeatureDie angegebenen Dateien/Verzeichnisse lesen.
FreitextDie 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:

  • gh nicht 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ängeZielwörterWPM
30 Sekunden~65 Wörter130
60 Sekunden~135 Wörter135
90 Sekunden~200 Wörter135
3 Minuten~400 Wörter135
5 Minuten~675 Wörter135

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 Filmmaterial
  • KAMERA: 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

  • gh nicht 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-post oder /social-copy verwenden)

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

Verwandte Skills