Communitygithub.com

Skriptbasiertes Video

Plane, recherchiere, schreibe, überprüfe und exportiere Videos, die als Skripte (Daten und Code, keine Zeitleistenbearbeitung) geschrieben und als MP4 gerendert werden.

Was ist Skriptbasiertes Video?

Diese Fähigkeit verwandelt die Videoproduktion in einen textbasierten, überprüfbaren Workflow. Ein Video ist hier ein **Skript** – eine Datei, die festlegt, was gesprochen wird, was auf dem Bildschirm zu sehen ist und wann. Eine kleine Engine (im `starter/`-Ordner) wandelt dieses Skript in ein Browser-Bild und schließlich in eine `.mp4`-Datei mit Ton, Untertiteln und Kapiteln um. Da das Video als Text vorliegt, kann es Zeile für Zeile geschrieben, geprüft, übersetzt und korrigiert werden, ohne dass eine aufwändige Bearbeitung nötig ist. Der Fokus liegt jedoch nicht nur auf der Technik, sondern auf der Kunst des Erzählens: Ein lehrreiches Video braucht eine wahre Geschichte, die der Zuschauer in der richtigen Reihenfolge, mit verständlichen Worten und passenden Bildern verfolgen kann. Die Fähigkeit führt den Nutzer durch 14 klar definierte Phasen – von der Erstellung eines Briefings über die Recherche (mit einem speziellen Drei-Runden-Verfahren), das Erstellen von Mindmaps und Storyboards, die Skripterstellung, mehrere Überprüfungsrunden (Genauigkeit, Verständnis, visuelle Qualität) bis hin zur Aufnahme von Stimme und Sound sowie dem finalen Export. Das Ziel ist ein fertiges Video, das der Auftraggeber nicht mehr korrigieren muss. Unterstützt werden Browser-Darstellung und Export als MP4, SRT/VTT-Untertitel und Kapiteldateien. Der Workflow ist für längere Sitzungen und die Zusammenarbeit mehrerer Agenten ausgelegt.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/utoappia/skill-tutorial_video_creation/tree/HEAD/skills/scripted-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Skriptbasiertes Video?

Ein Video ist hier ein Skript: eine Datei, die festlegt, was gesprochen wird, was auf dem Bildschirm zu sehen ist und wann. Eine kleine Engine (in starter/) verwandelt es in Bilder in einem Browser und in ein .mp4 mit Ton, Untertiteln und Kapiteln. Da das Video Text ist, können Sie es schreiben, überprüfen, Zeile für Zeile prüfen, jedes Bild ansehen, übersetzen und ein Wort korrigieren, ohne etwas neu bearbeiten zu müssen.

Die Engine ist die einfache Hälfte. Ein Video, das lehrt, braucht eine wahre Geschichte, erzählt in einer Reihenfolge, der der Zuschauer folgen kann, in Worten, die er kennt, mit Bildern, die auf das zeigen, was die Stimme nennt. Der Großteil dieser Fähigkeit dreht sich um diese Hälfte. Befolgen Sie die Phasen der Reihe nach; jede hinterlässt eine Datei, die die nächste liest, sodass die Arbeit eine lange Sitzung überdauert und ein zweiter Agent sie übernehmen kann.

Ziel ist es, ein Video zu übergeben, das der Auftraggeber nicht korrigieren muss. Seine Zeit sind die Kosten, die Sie einsparen. Also: Entscheiden Sie, was Sie entscheiden können, und schreiben Sie die Entscheidung auf; nutzen Sie jeden Dienst, jeden Schlüssel und jede Tatsache, die er angeboten hat; sehen Sie sich das Video vor der Übergabe so an, wie er es tun wird (siehe „Vor der Übergabe“). Die ersten Dinge, die einem Auftraggeber auffallen, sind fast nie Regelverstöße, die ein Prüfer finden kann. Es sind eine Vermutung, die das Video nie beantwortet hat, ein Thema ohne reale Substanz und ein Video, das sich unfertig anhört.

Drei Prinzipien gelten für jedes Video über die Welt. Jedes wird hier einmal genannt; die Phasen unten wenden sie an, und references/research.md gibt die Methode vor.

  • Erzählen Sie auf Kerntiefe; recherchieren Sie eine Ebene tiefer. Das Video, das Sie übergeben, ist der Kern: die kürzeste Erzählung, die das Versprechen hält und wahr und fair ist: etwa 10 bis 20 Minuten für ein Thema mit echten Geschichten, weniger für einen einzelnen Mechanismus. Eine vom Auftraggeber genannte Länge ist eine Grenze und hat Vorrang; die Recherchetiefe schrumpft dann mit ihr. Die Recherche geht eine Stufe weiter, bis zur Tiefe eines Details (die Personen, die entscheidenden Tage, die genauen Mittel, die konkurrierenden Figuren, was die Untersuchungen ergaben), sodass der Kern mit Wissen ausgewählt wird und damit benachbarte Themen auftauchen: ein Ereignis, eine Institution oder eine Idee, die das Hauptthema berührt und eine eigene Geschichte hat. Jedes wird zu einer Zeile in research/next-videos.md mit dem bereits Bekannten und wird nicht weiter recherchiert. Unterhalb eines Details (das spätere Leben jeder Person, jedes vollständige Dokument, die gesamte Geschichte einer Institution) liegt die Recherche eines anderen Videos: Bei einem Job wuchs das Video dadurch auf sechs Stunden, obwohl der 18-minütige Kern das war, was der Auftraggeber wollte. Längere Versionen werden nur auf Anfrage erstellt.
  • Jedes reale Beispiel zeigt das Hauptthema in Aktion. Eine wahre Geschichte kommt nur dann in das Video, wenn die Sache, um die es in dem Video geht, darin tatsächlich vorkommt, so wie die Quellen es erzählen: für ein Video über Terminmärkte, Terminkontrakte, die an einer Börse gehandelt werden, Margin Calls, ein erfüllter Kontrakt. Eine Geschichte, die nur in der Nähe liegt (die gleichen Jahre, ein berühmter Name, eine Wette, die ähnlich aussieht, aber auf andere Weise abgeschlossen wurde), bleibt draußen, so berühmt sie auch sein mag und selbst wenn der Auftraggeber sie vorgeschlagen hat. Überprüfen Sie dies an den Quellen in Runde 1, bevor Sie Tiefe darauf verwenden. Bei einem Job stellte sich die berühmteste Geschichte, die für ein Futures-Video angeboten wurde, als eine Wette heraus, die durch private Geschäfte mit Banken abgeschlossen wurde; sie wurde entfernt, nachdem zwei Ausgaben sie erzählt hatten. Kurz ist jedoch nicht dünn: Im Kern wird jedes reale Beispiel mit seinen Personen, seinem Datum, den genauen Mitteln, den Beträgen, wie es hätte schiefgehen können, wie es endete und was es über das Hauptthema zeigt, erzählt.
  • Die Recherche hat eine Grenze und ein Ende. Jede Spur wird am Hauptthema getestet, bevor eine Suche darauf verwendet wird; eine, die nicht passt, wird in einer Zeile notiert und fallengelassen („interessant“ öffnet sie nicht). Es gibt drei geplante Runden (die Gliederung, das Detail und eine doppelte Überprüfung aller Aussagen des Videos an den Quellen) und eine kurze vierte nur für benannte Elemente, die der Kern benötigt. Mehr ist die Entscheidung des Auftraggebers.

Standardzuschauer: jemand, der das Thema zum ersten Mal kennenlernt. Schreiben Sie so, dass ein 8-Jähriger folgen könnte, in ruhiger, professioneller Formulierung, die ein Erwachsener nicht kindisch finden würde. Einfach ist nicht dasselbe wie kindisch: kurze Sätze, alltägliche Wörter, eine Idee nach der anderen, kein Babytalk. Ändern Sie dies nur, wenn die Aufgabenstellung einen anderen Zuschauer nennt.

Einrichtung

Kopieren Sie den Ordner starter/ dieser Fähigkeit in das Projekt des Benutzers (z. B. als video/), dann:

cd video
npm install            # eine kleine Abhängigkeit; es verwendet das bereits auf dem Rechner vorhandene Chrome
node tools/check.mjs   # das Beispielvideo sollte bestehen

Erfordert: Node 18 oder neuer; Chrome, Edge oder Chromium (zum Zeichnen von Bildern); ffmpeg (zum Aufnehmen der Stimme und zum Exportieren). Wenn eines fehlt, siehe references/troubleshooting.md. Arbeiten Sie nicht im Fähigkeitsordner selbst; arbeiten Sie in der Kopie.

Die Kopie enthält ein Beispiel, videos/hello.json: fünfzehn Sekunden in einfachen Daten, mit einer Übersetzung und einem vertikalen Layout, das zur Überprüfung der Einrichtung dient. Was jede Phase produzieren soll, steht in den Dateien, die node tools/new.mjs erstellt: jede beginnt mit ihrer eigenen Checkliste. Löschen Sie das Beispiel, wenn das eigene Video des Benutzers in Arbeit ist.

Die Phasen

Starten Sie jedes Video mit node tools/new.mjs <id> "<Titel>". Es erstellt notes/<id>/ (die unten genannten Dateien mit ihren Checklisten) und ein Skriptgerüst in videos/<id>.mjs.

#PhaseSie produzierenErledigt, wennLesen Sie
0Briefingnotes/<id>/brief.mdZuschauer, Versprechen („Nach dem Ansehen kann der Zuschauer …“), Länge, Form und Sprache sind festgehalten, mit allem, was der Auftraggeber namentlich verlangt hat.unten
1Recherchemethoderesearch/00-how-to-research.mdSie wissen, wie Menschen, die dieses Fachgebiet kennen, Dinge herausfinden und wo Anfänger Fehler machen.references/research.md
2Recherche, in drei Rundenresearch/NN-name.md, research/leads.md, research/next-videos.md, research/index.mdJede Spur in leads.md ist abgeschlossen (recherchiert, nicht gefunden, nächstes Video, nebensächlich oder offen); jedes reale Beispiel besteht den Beispieltest und ist bis zur Tiefe eines Details bekannt; andere Ansichten und Mythen sind recherchiert; Runde 3 hat jede Behauptung, die für das Video bestimmt ist, an ihrer Quelle nochmals gelesen, und jede hat eine Quelle und ein Konfidenzlabel; was der Auftraggeber erinnert, hat ein Urteil. Die vollständige Liste: references/research.md, Abschnitt 11.references/research.md
3Mindmapmindmap.jsonJede recherchierte Idee ist core (im Video), support (recherchiert und wahr, nicht im Kern enthalten) oder cut (unbestätigt, unfair oder nebensächlich); die core-Ideen allein halten das Versprechen; node tools/mindmap.mjs <id> meldet keine Fehler.references/planning.md
4Storyboardstoryboard.md, assets.mdJeder Beat hat ein Bild, einen Kern, eine Komponente und einen Ton (normalerweise keinen); die Kontrollen am unteren Ende sind abgehakt.references/planning.md
5Skriptvideos/<id>.mjsnode tools/check.mjs <id> meldet keine Fehler und Sie haben jede Warnung gelesen. Das Skript hat Kernlänge.references/authoring-kit.md, references/components.md
6Genauigkeitsprüfungreview/accuracy.md, research/index.md (review/coverage.md nur für einen vollständigen Bericht)Jede Zeile von dump --claims hat ein Urteil und eine Quelle; für jede wahre Geschichte hat ein Prüfer, der sie nicht geschrieben hat, Skript, Notizen und Quellen verglichen (oder, wenn kein zweiter Agent vorhanden ist, haben Sie es getan, und die Datei sagt „nicht unabhängig"); die Recherche wurde nochmals mit dem Skript verglichen, und was der Kern brauchte und nicht hatte, ist jetzt darin; Korrekturen wurden in die Notizen zurückgeschrieben.references/script-review.md
7Verständnisprüfungreview/WhatIHaveLearned.md, review/lost-points.mdDas Tagebuch erreicht das Versprechen ohne Lücke, und jeder Weg, sich zu verlieren, hat eine Lösung oder einen Grund.references/script-review.md
8Visuelle Prüfungreview/visual.mdSie haben jedes Standbild angesehen und nichts ist abgeschnitten, verdeckt, leer oder unlesbar.references/visual-review.md
9Stimme und Tonaufgenommene Zeilen in out/tts/, Sounds in assets/<id>/Das Skript hat die Phasen 6 bis 8 bestanden und die Stimme ist aufgenommen; das Timing folgt nun der echten Stimme. Ereignisgeräusche sind gesetzt; Musik, falls vorhanden, liegt nur unter Geschichtsteilen.references/voice-and-assets.md
10Export und finale Ansichtout/<id>.mp4, .srt, .vtt, .chapters.txtSie haben Bilder der exportierten Datei selbst angesehen und ihren Ton überprüft.references/export-and-publish.md
11Andere Sprachen und Formen (falls gewünscht)videos/i18n/<id>.<lang>.jsonJede Sprache besteht die check, und ihre Standbilder wurden angesehen.references/localization.md
12Veröffentlichungssetpublish.mdTitel, Beschreibung, Kapitel, Untertitel, Vorschaubild, Quellen und Danksagungen sind bereit.references/export-and-publish.md
13Übergabedie Nachricht an den AuftraggeberDie Prüfung aus Auftraggebersicht ist erledigt; die Nachricht sagt, was entschieden wurde, was korrigiert wurde und was noch offen ist.references/finishing-and-revising.md

Schreibregeln, die ab Phase 4 gelten, finden Sie in references/writing-for-everyone.md (Wörter und Sätze) und references/teaching-techniques.md (wie man eine Idee vermittelt). references/visual-design.md behandelt Layout, Farbe und Bewegung. Lesen Sie diese drei, bevor Sie Ihr erstes Skript schreiben.

Phase 0: das Briefing

Füllen Sie brief.md basierend auf dem aus, was der Benutzer gesagt hat. Schreiben Sie für alles andere Ihre beste Annahme auf und markieren Sie sie „(angenommen)"; halten Sie nicht an, um zu fragen (siehe „Entscheiden, aufzeichnen, weitermachen"). Die wichtigste Zeile ist das Versprechen: ein Satz, der mit „Nach dem Ansehen kann der Zuschauer …" beginnt. Jede spätere Entscheidung (was recherchiert, was gestrichen wird, wann das Video fertig ist) wird daran gemessen. Notieren Sie auch, was der Zuschauer bereits weiß, denn dort beginnt das Video.

Kopieren Sie in das Briefing, in den eigenen Worten des Auftraggebers, alles, was er namentlich verlangt hat: einen zu verwendenden Dienst, einen Schlüssel und wo er sich befindet, ein Beispiel oder Ereignis, das aufgenommen werden soll, eine Tatsache, an die er sich erinnert, einen Teil, den er verwirrend fand, eine Einschränkung („großteils ohne Musik"). Jedes davon ist eine Zeile, die vor der Übergabe abgehakt werden muss. Ein genannter Dienst wird jetzt auf Erreichbarkeit geprüft, nicht erst in Phase 9; eine Tatsache, an die er sich erinnert, geht an die Recherche als etwas, das zu überprüfen ist, nicht als etwas, das wiederholt werden soll.

Entscheiden Sie hier, ob eine Recherche erforderlich ist. Überspringen Sie die Phasen 1 und 2 nur, wenn der Inhalt vollständig vorgegeben ist (das eigene Produkt des Benutzers, ein von ihm geschriebenes Skript, ein von ihm beschriebener Prozess) und Sie keine eigenen Fakten hinzufügen. Wenn Sie auch nur eine Zahl, ein Datum, einen Namen oder ein „weil" hinzufügen würden, recherchieren Sie es.

Phasen 1 und 2: Recherche

Bevor Sie das Thema recherchieren, recherchieren Sie wie man es recherchiert: zwei oder drei Suchen darüber, wie Menschen dieses Feld lernen und untersuchen, und eine Ebene darüber (für den Anleihemarkt: „wie man den Anleihemarkt versteht", dann „wie man etwas über die Wirtschaft lernt"). Sie sagen Ihnen, welche Quellen zählen, welche Zahlen wichtig sind und wo Anfänger Fehler machen. Dann drei Runden:

  1. Die Gliederung. Eine Notiz pro Thema, mit einer Zusammenfassung oben: Fakten mit Quellen, reale Ereignisse (jeweils zuerst durch den Beispieltest), alltägliche Vergleiche und die stärksten Gegenansichten und Mythen, genauso sorgfältig recherchiert wie die Hauptlinie.
  2. Das Detail. Listen Sie jede Person, jeden Ort, jedes Datum, jede Zahl, jeden Begriff, jeden Mechanismus, jede Ursache und jedes Zitat, das die Notizen erwähnen, ohne es zu erklären, in research/leads.md auf. Recherchieren Sie diejenigen, die das Hauptthema betreffen, einmal, bis zur Tiefe eines Details. Benachbarte Themen gehen in next-videos.md; der Rest wird als nebensächlich markiert.
  3. Die doppelte Überprüfung. Keine neuen Themen. Lesen Sie alles, was das Video sagen wird, erneut an seiner Quelle; finden Sie eine zweite, unabhängige Quelle für die überraschenden Behauptungen, die Zahlen, die die Größe der Geschichte angeben, die Zitate und alles, was sich negativ auf eine namentlich genannte Person auswirkt.

Planen Sie die Suchen, bevor Sie beginnen, und heben Sie ein Drittel für Runde 3 auf. Wenn Sie andere Agenten starten können, geben Sie jedes reale Ereignis einem eigenen Agenten und die doppelte Überprüfung einem, der die Notiz nicht geschrieben hat.

Zwei Dinge, auf die das fertige Video zurückgreifen können muss:

  • Reale Ereignisse, bekannt bis zur Tiefe eines Details. Eine erfundene Person macht eine Idee leicht verständlich; ein reales Ereignis lässt den Zuschauer daran glauben und es sich merken. Für ein Thema mit einer Geschichte (ein Markt, eine Technologie, eine Institution) recherchieren Sie mindestens zwei. Wenn eines zeigt, wie jemand gewinnt, recherchieren Sie, wie es hätte scheitern können, und finden Sie eines, bei dem jemand verloren hat: Ein Sieg allein lehrt die falsche Lektion. Für einen Mechanismus der Natur oder eine Methode (warum der Himmel blau ist, wie man einen Knoten macht) reicht eine reale Beobachtung, Messung oder Entdeckung, oder keine: Schreiben Sie „keine, weil …" in das Briefing.
  • Was der Auftraggeber erinnert, überprüft. Es ist eine Spur und oft teilweise falsch. Überprüfen Sie jeden Teil, verwenden Sie, was zutrifft, und teilen Sie ihm mit, was Sie korrigiert haben und warum; wiederholen Sie niemals eine Behauptung, weil „der Auftraggeber es gesagt hat", und lassen Sie sie niemals stillschweigend weg.

Einzelheiten: references/research.md.

Phase 3: die Mindmap

mindmap.json ist ein kurzer Baum jeder Idee, die das Video enthalten könnte (Knotenarten sind in references/planning.md Abschnitt 1 aufgelistet; node tools/mindmap.mjs nennt sie, wenn eine falsch ist). Jeder Knoten sagt in wenigen Worten, was die Idee ist, wo ihre Details in der Recherche leben ("file.md#Heading"), welche Ideen der Zuschauer zuerst braucht und mit welchen anderen Ideen sie verbunden ist. Jede Idee ist core (im Video: das Versprechen braucht sie, eine wahre Geschichte kann nicht ohne sie erzählt werden, oder Fairness erfordert sie), support (recherchiert und wahr, nicht im Kern enthalten: Material für die Beschreibung, eine längere Version, falls der Auftraggeber fragt, oder ein nächstes Video) oder cut (unbestätigt, kann nicht fair erzählt werden oder hat nichts mit dem Hauptthema zu tun; eine reale Geschichte, die den Beispieltest nicht besteht, ist cut). Das Werkzeug prüft, dass jeder Zeiger irgendwohin führt und dass nichts gelehrt wird, bevor das Nötige dafür vorhanden ist. Einzelheiten: references/planning.md.

Phase 4: das Storyboard

Eine Tabelle, eine Zeile pro Beat: was der Zuschauer sieht, der Kern dessen, was die Stimme sagt, welche Komponente es zeichnet, ob ein neues Wort erscheint und was außer der Stimme zu hören ist (für Musik „Musik: "; für Soundeffekte das Ereignis, z. B. „Klick", „Krachen", „Nähmaschine"; lassen Sie die Soundeffekte, die die Engine von sich aus erzeugt, weg – siehe references/components.md). Die Spalten sind unten aufgeführt.

Jede Zeile ist ein Beat: die kleinste Einheit, die der Zuschauer als einen Moment erlebt, normalerweise ein bis drei Sätze oder eine Animation, die einen Punkt macht. Zwei bis fünf Beats bilden eine Szene; eine Szene deckt einen Schritt der Logik oder einen Teil der Geschichte ab.

Spalten (von links nach rechts):

  • SZENE – ein Name wie „Öffnung" oder „Die Pleite von Barings". Zeilen, die zur gleichen Szene gehören, teilen sich diese Zelle. Sie können sie in der ersten Zeile der Szene ausfüllen und die anderen leer lassen.
  • SEHEN – was auf dem Bildschirm ist. Ein bis zwei Sätze; bei Bedarf eine Skizze.
  • STIMME – die Kernaussage dessen, was der Sprecher sagt. Ein bis zwei Sätze des Skripts; Sie werden später jedes Wort daraus schreiben.
  • KOMPONENTE – aus references/components.md. Meistens fallback-slide, code, two-columns oder custom. Der Name der Komponente ist die CSS-Klasse; verwenden Sie den genauen Namen.
  • WORT – ein neues Wort, das der Zuschauer an dieser Stelle zum ersten Mal sieht oder hört. Füllen Sie es nur aus, wenn eines ankommt.
  • TON – Stimme (Standard, lassen Sie es leer, wenn es nichts anderes gibt), Musik: <Stimmung>, Sound: <Ereignis> oder Stille.

Einzelheiten: references/planning.md Abschnitte 4–6, mit dem vollständigen Tabellenformat in Abschnitt 4.

Phase 5: das Skript

Schreiben Sie videos/<id>.mjs. Das Format ist in references/authoring-kit.md definiert; die verfügbaren Komponenten sind in references/components.md aufgeführt und die Engine zeigt eine Fehlermeldung, wenn Sie eine falsche eingeben.

Füllen Sie für jeden Beat das voice-Feld mit den genauen Wörtern, die der Sprecher sagt. Verwenden Sie einen .mjs-Export (ein Objekt mit metadata, slides und voice; siehe das Beispiel). Setzen Sie voice.speed erst, nachdem Sie die Audiodatei aufgenommen haben (Phase 9).

Schreiben Sie das Skript auf Kernlänge. Wenn der Auftraggeber eine bestimmte Minutenanzahl genannt hat, ist dies eine Grenze; lassen Sie die Recherche und die Ideen, die sie gestützt haben, in den Notizen, aus denen eine längere Version erstellt werden kann.

Zwei-Regel: Verwenden Sie für jede Idee zwei Arten, sie zu zeigen: die Stimme sagt es, und das Bild zeigt es, oder ein Beispiel veranschaulicht es, oder es wiederholt sich in einer anderen Form. Der Zuschauer erhält die Idee also über zwei Kanäle oder zwei Instanzen. Wenn Sie nur eine haben, überlegen Sie, ob diese Idee so wichtig ist, dass sie ihren eigenen Beat verdient – und wenn nicht, ob sie weggelassen werden kann, ohne das Versprechen zu brechen.

Die drei schlimmsten Fehler in Skripten, die hier geschrieben wurden: (1) Der Sprecher beschreibt, was bereits auf dem Bildschirm zu sehen ist, anstatt es zu erweitern. Wenn das Bild die Idee bereits zeigt, sagen Sie entweder nichts (lassen Sie eine Pause) oder sagen Sie, warum es wichtig ist. (2) Der Sprecher sagt eine Zahl, ohne zu sagen, was sie bedeutet („21,4 Milliarden" – im Vergleich zu was?). Sagen Sie immer die Einheit und die Richtung oder den Vergleich. (3) Der Sprecher wechselt den Gegenstand oder die Zeit in der Mitte eines Beats. Ein Beat hat ein Subjekt und eine Zeit; wenn eines davon wechselt, beginnen Sie einen neuen Beat.

Einzelheiten: references/authoring-kit.md (was in jeder Eigenschaft steht, Namenskonvention, wie man eine Pause setzt). references/teaching-techniques.md (Reihenfolge der Ideen, Analogien, Metaphern, Beispiele). references/writing-for-everyone.md (Satzlänge, Wortschatz, Komplexität).

Phase 6: Genauigkeitsprüfung

Führen Sie dump --claims aus (das Werkzeug ist in node tools/check.mjs integriert; fragen Sie, wie es geht) für jede Behauptung. Jede muss ein Urteil haben und woher Sie es wissen. Für jede wahre Geschichte: Ein Prüfer, der sie nicht geschrieben hat, hat das Skript, die Notizen und die Quellen verglichen (oder, wenn kein zweiter Agent vorhanden ist, sagen Sie „nicht unabhängig" im Review). Vergleichen Sie die Recherche erneut mit dem Skript: Ist etwas, das im Kern sein sollte, nicht dort? Ist eine Quelle anders, als Sie sie geschrieben haben?

Schreiben Sie Korrekturen in die Notizen zurück. Löschen Sie keine Notiz, weil das Skript sie nicht verwendet hat; sie könnte für ein nächstes Video nützlich sein oder für eine spätere Frage des Auftraggebers. Markieren Sie sie als „nicht im Kern " im Index, wenn das die sauberste Art ist, sie aufzubewahren.

Einzelheiten: references/script-review.md.

Phase 7: Verständnisprüfung

Sie spielen den Zuschauer. Öffnen Sie die Videodateien, das Storyboard und das Skript. Schreiben Sie ein kurzes Tagebuch (WhatIHaveLearned.md) darüber, was Sie nach jedem Abschnitt verstanden haben. Wenn das Tagebuch das Versprechen nicht auf natürliche Weise erreicht – wenn es eine Lücke gibt, in der etwas fehlt, oder einen Spring, bei dem der Zuschanner raten muss, wie man von A nach B kommt –, markieren Sie die Stelle in lost-points.md und schlagen Sie eine Korrektur vor.

Lesen Sie das Skript auch einer Person vor, die das Thema nicht kennt (oder stellen Sie es sich vor). Halten Sie an jeder Stelle inne, an der Sie zögern. Jedes Zögern ist ein verlorener Punkt.

Einzelheiten: references/script-review.md Abschnitt „Verständnisprüfung".

Phase 8: Visuelle Prüfung

Öffnen Sie die Vorschau im Browser (node tools/preview.mjs <id> oder wie im Kit beschrieben). Gehen Sie jeden Frame durch – oder lassen Sie die Engine im Zeitraffer laufen und halten Sie an zufälligen Stellen an. Prüfen Sie:

  • Ist der Text lesbar? (Größe, Kontrast, Überlappung)
  • Ist das Bild vollständig? (Nichts abgeschnitten, kein leerer Bereich, auf den der Sprecher zeigt, der aber nicht da ist)
  • Funktioniert die Animation, wenn es eine gibt? (Kein Ruckeln, keine leeren Frames)
  • Ist der Farbeindruck für Farbenblinde zugänglich? (Wenn Sie die Engine-Farbe verwenden, ist dies bereits erledigt; wenn Sie benutzerdefinierte Farben haben, überprüfen Sie es.)

Einzelheiten: references/visual-review.md.

Phase 9: Stimme und Ton

Nehmen Sie die Stimme auf (das Engine-Kit enthält eine TTS-Brücke; siehe references/voice-and-assets.md). Nach der Aufnahme setzen Sie voice.speed in der Videodatei, sodass die Dauer der Zeilen mit den tatsächlichen Audiodateien übereinstimmt.

Legen Sie für jeden Beat, der einen Soundeffekt benötigt, die Audiodatei in assets/<id>/ ab und referenzieren Sie sie in der Komponente (jede Komponente hat ein sound-Feld; siehe das Kit). Begrenzen Sie Soundeffekte auf eine pro Beat, es sei denn, die Szene erfordert mehrere (z. B. eine Baustelle). Verwenden Sie Musik sparsam: nur unter Geschichtsteilen (nicht unter Voiceover, nicht unter Erklärungen) und nur, wenn sie die Stimmung verstärkt, nicht, wenn sie nur den Raum füllt.

Einzelheiten: references/voice-and-assets.md.

Phase 10: Export und finale Ansicht

Exportieren Sie die .mp4 (das Engine-Kit enthält ein Skript dafür; siehe references/export-and-publish.md). Prüfen Sie:

  • Öffnen Sie die .mp4 und sehen Sie sie sich an (nicht nur die Vorschau im Browser – die Export-Engine kann die Farben oder die Schriftart ändern).
  • Hören Sie den gesamten Ton: keine Verzerrungen, keine toten Stellen, die Musik überdeckt nicht die Stimme.
  • Die Untertitel (srt/vtt) sind vorhanden und ihre Zeiten stimmen.
  • Die Kapiteldatei (chapters.txt) hat die richtigen Zeiten.

Wenn der Auftraggeber mehrere Formate verlangt hat (vertikal, quadratisch), exportieren Sie jedes.

Einzelheiten: references/export-and-publish.md.

Phase 11: Andere Sprachen und Formen (falls gewünscht)

Erstellen Sie eine Übersetzungsdatei in videos/i18n/<id>.<lang>.json. Das Format ist in references/localization.md definiert; die Engine wendet sie an, wenn Sie node tools/preview.mjs <id> --lang <lang> ausführen.

Übersetzen Sie die Stimme, den Text auf dem Bildschirm (in den Komponenten) und alle Untertitel, die nicht automatisch aus der Stimme generiert werden. Passen Sie die Längen an, wenn die Übersetzung länger oder kürzer ist als das Original; Sie müssen möglicherweise die Beat-Grenzen verschieben oder Frames hinzufügen. Die Engine warnt Sie, wenn eine übersetzte Zeile die Bildschirmbreite überschreitet.

Zeigen Sie jedes Standbild für die übersetzte Sprache an (Phase 8); eine andere Sprache kann andere visuelle Probleme verursachen.

Einzelheiten: references/localization.md.

Phase 12: Veröffentlichungsset

Schreiben Sie publish.md mit:

  • Titel und Beschreibung (für YouTube, Vimeo usw.)
  • Kapitelmarken (aus der Kapiteldatei, mit Beschreibungen)
  • Untertitel (aus den .vtt- oder .srt-Dateien)
  • Vorschaubild (welches Standbild oder ob ein benutzerdefiniertes erstellt werden soll)
  • Quellen (Liste der verwendeten Quellen, mit Links, falls öffentlich)
  • Danksagungen (falls Sie Musik oder Töne von Drittanbietern verwendet haben)

Einzelheiten: references/export-and-publish.md.

Phase 13: Übergabe

Bevor Sie die Datei an den Auftraggeber senden, sehen Sie sie sich als Auftraggeber an:

  • Öffnen Sie die .mp4 – nichts weiter. Sehen Sie sie sich vom Anfang bis zum Ende an. Notieren Sie den ersten Moment, in dem Sie innehalten oder sich eine Frage stellen. Dieser Moment ist das, was der Auftraggeber als Erstes bemerken wird.
  • Dann lesen Sie das Briefing noch einmal. Haben Sie alles getan, was auf der Liste stand? Wenn nicht, sagen Sie warum.
  • Ist das Versprechen erfüllt? Wenn nicht, sagen Sie, was noch offen ist.

Senden Sie:

  • Die .mp4 (oder mehrere, falls erforderlich).
  • Die Untertiteldatei(en) und die Kapiteldatei.
  • publish.md.
  • Eine kurze Nachricht mit dem, was Sie entschieden haben (z. B. „Ich habe den Abschnitt über X weggelassen, weil die Quellen zeigten, dass er nicht zum Hauptthema gehört"), was Sie korrigiert haben („Eine der Zahlen war falsch; ich habe sie durch die korrekte aus Quelle Y ersetzt") und was noch offen ist („Die Übersetzung ins Französische ist noch nicht fertig; ich sende sie morgen nach").

Entscheiden, aufzeichnen, weitermachen. Wenn eine Frage während der Arbeit auftaucht (soll ich diesen Punkt aufnehmen? Diese Quelle? Diese Szene um 5 Sekunden verlängern?), treffen Sie eine Entscheidung, schreiben Sie sie im Briefing oder in den Recherchenotizen auf und machen Sie weiter. Halten Sie nicht an, um den Auftraggeber zu fragen, es sei denn, die Entscheidung könnte das Versprechen brechen oder ihn dazu zwingen, das fertige Video abzulehnen. Wenn Sie anhalten müssen, fragen Sie eine Sache auf einmal, mit einer kurzen Erklärung der Optionen, und setzen Sie eine Frist („Bitte antworten Sie bis zum Ende des Tages, damit ich das Video morgen fertigstellen kann").

Einzelheiten: references/finishing-and-revising.md.

Lösung häufiger Probleme

Siehe references/troubleshooting.md. Enthält: Engine startet nicht, Chrome nicht gefunden, Fehler bei der Abhängigkeit sharp, Export schlägt fehl, TTS-Dienst verweigert, ffmpeg fehlt, die Liste der erwarteten CLI-Befehle.

Verwandte Skills