Dokumentarfilm
Der Benutzer gibt ein Thema vor. Du lieferst einen fertigen Film: out/<slug>.mp4 (1920×1080, H.264/AAC), plus .srt, CREDITS.md, das Skript und die Quellen. Der Benutzer muss nichts selbst installieren, recherchieren, schreiben oder rendern. Halte nur an, wenn eine Entscheidung wirklich beim Benutzer liegt: eine kostenpflichtige Generierung, ein Download, der eine Genehmigung erfordert, oder eine Tatsachenbehauptung, die nicht überprüft werden kann.
SKILL_DIR ist dieser Ordner. DOC bedeutet python3 "$SKILL_DIR/scripts/doc.py".
1. Einrahmen, bevor du schreibst
Stelle höchstens zwei Fragen, und nur, wenn sie den Film verändern: Länge (Standard 3 Minuten) und Perspektive (was der Film argumentiert, nicht nur sein Thema). Alles andere entscheidest du.
Ein Dokumentarfilm ist ein Argument mit Bildern, keine Zusammenfassung. Wähle eine Aussage, die ein Zuschauer nach dem Anschauen wiederholen kann – „Der Leuchtturmwärter hat nicht gegen die Technik verloren, sondern gegen eine Tabelle“ – und streiche alles, was nicht dieser Aussage dient.
Filme niemals eine Liste von Fakten. Filme eine Veränderung: etwas war wahr, dann war es nicht mehr wahr, und hier ist, was das gekostet hat.
2. Einrichtung (nur beim ersten Durchlauf)
DOC doctor
Erfordert python3 und ffmpeg mit libx264. Termux: pkg install ffmpeg. macOS: brew install ffmpeg. Fehlt nur ffmpeg, installiere es und führe den Befehl erneut aus. Schreibe nichts anderes, bis doctor „Bereit“ meldet.
DOC new <projekt> --title "Der letzte Leuchtturmwärter" --subtitle "1985 – 1997"
Das erstellt project.json, shots.json, research.md, script.md und die Ordner work/img, work/audio, out.
3. Recherche
Nutze Websuche. Ziel sind vier bis sechs solide Quellen: Primärdokumente, Archive, Universitäts- oder Behördensseiten, seriöser Journalismus, ein Buch. Lese genug, um den Mechanismus zu erklären, nicht nur das Ergebnis.
Speichere in research.md:
# Recherche
## These
Ein Satz, den der Film argumentiert.
## Fakten (jeweils mit Quelle)
- 1841: <Fakt> – <Quellen-URL>
- <Zahl>: <Fakt> – <Quellen-URL>
## Umstritten / Unbekannt
- <worum Quellen streiten und wie der Film es formulieren wird>
## Bildmaterial
- <Archive, Sammlungen, wahrscheinliche Public-Domain-Bildersuchen>
Jeder Satz im Kommentar muss auf eine Zeile hier zurückgeführt werden können. Wenn zwei Quellen sich widersprechen, entweder auf dem Bildschirm erwähnen oder den Fakt weglassen. Erfinde keine Zahl, kein Datum, kein Zitat und keine Anekdote. Ein fehlender Fakt ist ein Plot-Problem; ein erfundener ist Betrug.
4. Das Skript schreiben
Lies references/script-craft.md vor dem Schreiben. Kurz gefasst:
- 155 Wörter pro Minute. 3 min = ~460 Wörter. Budgetiere nach Akt, nicht nach Gefühl.
- Vier Bewegungen: die Welt zuvor (Aufhänger), der Mechanismus (wie die Veränderung funktionierte), die Kosten (was sie den Menschen antat), das Echo (Rückkehr zum Aufhänger, verändert).
- Eine Idee pro Satz. Ein Atemzug pro Zeile. Kein Satz über 22 Wörter.
- Konkret statt abstrakt. „Er kletterte zweimal pro Nacht 117 Stufen hoch“ schlägt „der Job war anstrengend“.
- Präsens für die Geschichte, Präteritum für das Urteil.
- Der Kommentar trägt das Argument; die Einblendungen tragen die Beweise (Namen, Daten, Orte). Sage niemals auf der Tonspur, was die Einblendung bereits beweist.
Schreibe es in script.md als Akte, ein Satz pro Zeile, weil die Zeilen in shots.json wörtlich übereinstimmen müssen:
## Akt I – die Welt zuvor
Zweihundert Jahre lang musste jemand wach bleiben, damit Schiffe das Ufer fanden.
...
Dann zeige dem Benutzer das gesamte Skript in einer Nachricht – etwa 30 Zeilen – und fahre fort. Warte nicht auf Zustimmung, es sei denn, der Benutzer hat darum gebeten, es zu überprüfen.
5. Shot-Liste
Lies references/shot-list.md für jedes Feld und ein vollständiges Beispiel, dann schreibe shots.json:
{"shots": [
{"id": "s01", "kind": "card", "text": "Der letzte Leuchtturmwärter",
"sub": "Ein Beruf, der in zwölf Jahren verschwand", "hold": 4.0},
{"id": "s02", "line": "Zweihundert Jahre lang musste jemand wach bleiben.",
"img": "work/img/cape-byron-1891.jpg", "motion": "zoom-in",
"caption": "Cape Byron, 1891"}
]}
Wichtige Regeln:
lineist der Kommentar, wörtlich aus dem Skript, in der richtigen Reihenfolge. Die Dauer ergibt sich aus dem Audio, daher ändert eine geänderte Zeile den Schnitt.- 3,5 – 6 Sekunden pro Shot. Ein Standbild braucht länger, als du denkst. Nie unter 2,5 s, außer bei einem bewussten Blitz.
- Ein Bild, eine Idee. Wenn ein Shot zwei Bilder braucht, sind es zwei Shots.
- Bewege die Kamera, nicht die Welt.
zoom-infür Intimität,zoom-outfür Konsequenzen,pan-*für Landschaften und Dokumente,staticfür Gesichter und Text. - Eine Karte ist ein Kapitelwechsel. Verwende 2–4 in einem 3-Minuten-Film: Titel, ein Datum oder eine Zahl, und eine letzte Karte, die landet. Karten haben keinen Kommentar.
captionist die kleine Bildschirm-Beweiszeile: Ort, Jahr, Quelle. Bleibe unter 6 Wörtern.
6. Standbilder
Bevorzuge echtes Archivmaterial. Es ist der Unterschied zwischen einem Dokumentarfilm und einer Diashow.
DOC archive <projekt> --query "Cape Byron lighthouse 1900" --n 3
Dies durchsucht Wikimedia Commons, lädt verwendbare Bilder in work/img/ herunter und schreibt sources.json + CREDITS.md mit Autor und Lizenz. Standardmäßig werden nur Public Domain, CC0 und CC BY / BY-SA behalten, da ein veröffentlichter Film in der Regel eine kommerzielle Nutzung benötigt. Füge --license pd für strenge Public Domain hinzu oder --license any, um alles zu sehen (dann prüfe jede Lizenz selbst).
Wenn das Archiv nichts hergibt, in dieser Reihenfolge:
- Andere offene Sammlungen – Library of Congress, Smithsonian Open Access, NASA, Internet Archive, Europeana. Frage den Benutzer, bevor du von einer neuen Seite herunterlädst, und notiere die Lizenz und URL in
CREDITS.md. - Generiere ein Bild mit jedem dir verfügbaren Bildwerkzeug, unter Verwendung von
references/image-prompts.md. Markiere generierte Bilder inCREDITS.mdals KI-generierte Rekonstruktion und beschrifte sie so, dass ein Zuschauer nie in die Irre geführt wird, sie für Fotos zu halten. - Typografische und Objektaufnahmen – ein Dokument, eine Karte, eine Seite eines Logbuchs, eine abstrakte Tafel. Ehrlich und günstig.
Präsentiere niemals ein KI-Bild als Archivmaterial. Diese eine Zeile ist die gesamte Ethik des Formats.
7. Kommentar (Voiceover)
DOC tts <projekt>
Verwendet ElevenLabs, wenn ELEVENLABS_API_KEY gesetzt ist (am besten), ansonsten eine Offline-Stimme (espeak-ng, Android termux-tts-speak, macOS say). Ein Take. Schreibe für das Ohr: kurze Sätze, keine Zungenbrecher, Zahlen werden so geschrieben, wie sie gesprochen werden.
Wenn es gar keine Stimme gibt, rendert der Film trotzdem mit geschätzten Timings – sage das, und liefere die .srt, damit der Benutzer später seinen eigenen Kommentar aufnehmen kann. Lasse line unverändert, damit eine Neuaufnahme direkt eingefügt werden kann.
Aufnahmequalität übertrifft Modellqualität: Eine Telefonaufnahme in einem ruhigen Raum ist für die meisten Dokumentarfilme besser als eine synthetische Stimme. Biete das an.
8. Bauen und ansehen
DOC build <projekt> --draft # schneller Durchlauf während der Iteration
DOC build <projekt> --subs # endgültig, Untertitel eingebrannt
DOC sheet <projekt> # 12-Frame-Kontaktabzug
Sieh dir jedes Mal out/contact.jpg an. Überprüfe:
- nichts Wichtiges liegt unter einer Einblendung, und keine Einblendung läuft aus dem Bild;
- Schnitte landen an Satzenden, und kein Shot hält auf einem leeren oder irrelevanten Teil eines Bildes;
- die Gradierung ist konsistent, Gesichter sind nicht ausgebrannt, und Textbilder sind lesbar;
- die letzte Karte erscheint, nachdem der Kommentar aufgehört hat, nicht darüber.
Behebe, indem du shots.json bearbeitest (Bild, Bewegung, Einblendung, Reihenfolge) und neu baust. Interne Clips werden nach Shot-ID zwischengespeichert, sodass nur geänderte Shots neu gerendert werden.
Geschwindigkeit. Das Rendern ist CPU-lastig. Bei 1080p dauert ein Dreiminutenfilm etwa eine Minute auf einem Laptop und 10–20 Minuten auf einem Telefon. Iteriere immer mit --draft (halbe Auflösung, schnelles Preset) und führe am Ende einen vollständigen Durchlauf durch. build gibt jeden Shot während der Verarbeitung aus, sodass du einen offensichtlich falschen Render stoppen kannst.
9. Musik
Frage, bevor du Musik hinzufügst. Schlage eine Quelle vor, überprüfe die Lizenz, lege die Datei unter public/music/bed.mp3 ab, dann:
DOC build <projekt> --music public/music/bed.mp3
Sie loopt, liegt bei ~14 % Lautstärke und duckt sich automatisch unter die Stimme. Stille ist eine legitime Wahl und oft die bessere für einen ernsten Film.
10. Liefern
Gib dem Benutzer:
- das MP4;
- die
.srt(auch nützlich für YouTube); CREDITS.md– jedes Standbild, Autor, Lizenz, Link;- das Skript, einen Absatz zur Perspektive und 3–5 Quellenlinks;
- eine ehrliche Angabe, was archiviert, was generiert und was aus Mangel an Beweisen weggelassen wurde.
Biete dann einen nächsten Schritt an: einen längeren Schnitt, einen anderen Einstieg, einen zweiten Akt oder denselben Film als vertikalen 60-Sekunden-Schnitt.
Gutes Urteilsvermögen
- Der Film ist das Argument, nicht das Filmmaterial. Wenn die Bilder schön sind, die Behauptung aber vage ist, schreibe neu.
- Streiche das dritte Beispiel. Zwei beweisen ein Muster; drei sind eine Liste.
- Quellen auf dem Bildschirm, nicht nur in der Beschreibung. Eine Einblendung mit Jahr und Ort ist es, die einen Zuschauer den Rest glauben lässt.
- Sage, was du nicht weißt. „Niemand ist sich über die Zahl einig“ ist eine stärkere Aussage als eine selbstbewusste falsche.
- Respektiere die Toten. Echte Menschen, echte Ereignisse: keine erfundenen Dialoge, keine Nachstellung, die als Aufnahme präsentiert wird, keine generierten Gesichter für namentlich genannte Personen.
- Länge ist ein Versprechen. Wenn das Material nur 90 Sekunden hergibt, liefere 90 Sekunden.
Dateien
scripts/doc.py– die gesamte Pipeline (DOC -hfür alle Flags).references/script-craft.md– wie man einen Kommentar schreibt, der sich wie ein Film anhört.references/shot-list.md– vollständigesshots.json-Schema und ausgearbeitetes Beispiel.references/sourcing.md– Archive, Lizenzregeln, Quellenangabenformat.references/image-prompts.md– Prompts für generierte Standbilder, die sich mit Archivmaterial schneiden.examples/last-lightkeeper/– ein fertiges 3-Shot-Beispiel (Skript + Shots).