JaviMaligno/agilabs-video-studio

Erklärskript

Ein Skript ist eine kurze Liste von Szenen. Jede Szene hat eine oder mehrere Erzählzeilen und eine visuelle Darstellung. Es ist für einen Betrachter geschrieben, der mit ausgeschaltetem Ton scrollt, daher muss jede Zeile auch als Untertitel funktionieren.

Länge

• 30–60 s, Ziel 45 s (targetSeconds in src/settings.ts).
• Das entspricht etwa 75–140 gesprochenen Wörtern auf EN. Zähle sie. Spanisch ist für denselben Inhalt etwa 15–20 % länger.

Struktur

1. Hook, innerhalb der ersten 3 s. Die überraschende Erkenntnis oder eine konkrete Frage. Niemals „In diesem Video...“, „Heute möchte ich über... sprechen“ oder eine Begrüßung. Einleitungskarte.
2. Setup. Was getestet wurde und warum es wichtig ist, in ein oder zwei Zeilen.
3. Das Experiment in einem Bild. Der Mechanismus oder das Design als eine visuelle Darstellung (ein Ablauf, ein Vergleich). Eine Idee, nicht der gesamte Methodenteil.
4. Das Ergebnis mit seiner exakten Zahl. Die Zahl, wie der Artikel sie schreibt („14/20 vs 4/20“, „83 %“, „p = 0,0018“): gleiche Rundung, gleiche Einheiten.
5. Fazit. Was das Ergebnis für jemanden bedeutet, der damit etwas baut – nicht stärker als im Artikel behauptet.
6. Outro-Kartenzeile: „More at javieraguilar.ai“ (ES: „Más en javieraguilar.ai“).

Stimme

• Erste Person, wie der Artikel geschrieben ist: „Ich gab dem Planer…“, „Was ich fand…“.
• Behauptungen so differenziert wie im Artikel. Behalte seine Abschwächungen bei („bei diesen Läufen“, „in diesem Setup“).
• Kurze gesprochene Sätze. Eine Idee pro Zeile. Kein Fachjargon, den der Artikel nicht erklärt.

Untertitel

• Untertitel werden aus dem Erzähltext eingebrannt, maximal zwei Zeilen mit ~32 Zeichen.
• Maximal 17 Zeichen pro Sekunde auf dem Bildschirm (npm run lint prüft es). Eine Zeile, die zu schnell gelesen wird, benötigt weniger Wörter, keine schnellere Stimme.
• Schreibe Zahlen im Untertitel so, wie der Artikel es tut. Wenn die TTS sie anders aussprechen soll, gib der Zeile eine gesprochene Form (siehe narration Skill); ändere niemals den Untertitel dafür.
• Vermeide lange URLs und Code-Identifikatoren in der Erzählung; sie brechen schlecht um und lassen sich noch schlechter lesen.

EN und ES

• Schreibe das EN/ES-Paar zusammen, Zeile für Zeile, sodass beide Schnitte im Schritt bleiben. ES ist optional: Lasse den ES-Text leer, während ein Video nur auf EN ist.
• Die ES-Zeile sagt dasselbe, keine wörtliche Übersetzung; halte sie so kurz wie EN.

Visuelles pro Szene

Jede Szene erhält eine visuelle Idee, die einer Komponente aus der Bibliothek zugeordnet ist (siehe explainer-animation):

Visuelle Idee	Komponente
Eine einzelne Schlagzeilenzahl, die hochzählt	Counter
Zwei bis fünf Werte nebeneinander	BarCompare
Eine Pipeline, eine Übergabe, eine defekte Verbindung	FlowDiagram
Der Satz, auf den der Artikel aufbaut	KeyQuote
Zwei bis vier Zahlen gleichzeitig	StatGrid
Hook und Abschluss	Intro / Outro-Karten

Wenn keine Komponente passt, markiere die Szene als „Bespoke“ mit einer einzeiligen Beschreibung der Animation. Vermeide ein Video, das nur aus Text auf Farbverlauf besteht: Jeder Artikel erhält mindestens eine visuelle Darstellung, die seinen Mechanismus zeigt.

Skriptformat

Schreibe script.md als Tabelle, eine Zeile pro Erzählzeile:

Szene	Komponente	EN Zeile	ES Zeile	Visuelles	Quellsatz

• „Quellsatz“ zitiert den Artikel für jede Zahl und jede Behauptung in der Zeile.
• Ende mit der Wortanzahl (EN) und der geschätzten Länge.
• Präsentiere es zur Genehmigung, bevor irgendetwas gebaut wird.