Skill für Erklärvideos (Hellboy)
Du verwandelst ein technisches Thema in ein fertiges 2–3-minütiges 1080×1920 MP4, das ein Nicht-Techniker auf Anhieb versteht. Der visuelle Stil, das Tempo und die Skriptstruktur sind von einem Referenzkanal übernommen (analysiert in docs/01-style-bible.md). Zwei Dinge stammen bewusst von uns: die Figur (Hellboy) und die Stimme.
Du schreibst nur Textdateien (ein Skript und ein storyboard.json). Die Engine in engine/ erledigt die Stimme, Untertitel, Animation, Figur, Musik und das Rendering.
Wenn der Benutzer nur ein Thema vorgibt
Erledige den gesamten Vorgang, ohne weitere Fragen zu stellen:
- Erstelle einen Slug aus dem Thema (
wie-dns-funktioniert) und führepython engine/make_video.py new videos/<slug>aus. - Schreibe
videos/<slug>/script.md(docs/02), dannvideos/<slug>/storyboard.json(docs/03 + docs/04). Kopiere Muster ausexamples/upi-explained/. - Führe
python engine/validate_storyboard.py videos/<slug>aus. Korrigiere jeden FEHLER und wiederhole, bis0 error(s)ausgegeben wird. - Führe
python engine/make_video.py preview videos/<slug>aus. Wenn du Bilder sehen kannst, überprüfebuild/preview.pnganhand von docs/06 Abschnitt B und korrigiere. - Führe
python engine/make_video.py render videos/<slug>aus. Antworte mit dem Pfadoutput/<slug>.mp4, der Dauer und einer 2-zeiligen Zusammenfassung.
Die unverhandelbaren Regeln
- Hellboy wird nie neu gezeichnet. Er kommt nur aus
character/hellboy/hellboy.js. Du darfstshow,arm(down/point/explain) undexpressionsetzen, sonst nichts. Liescharacter/hellboy/CHARACTER_BIBLE.mdeinmal. - Die Stimme ist fest in
engine/config.jsoneingestellt. Ändere sie nicht pro Video. - Länge: 360–470 Wörter Erzähltext, 2:00–2:50. Sätze ≤ 20 Wörter.
- Jeder Satz verändert etwas auf dem Bildschirm. Elemente erscheinen bei ihrem gesprochenen Stichwort (
"at"). - Richtig ist besser als einfach. Vereinfache, indem du Dinge weglässt, niemals, indem du etwas Falsches sagst.
- Validator muss bestehen (
0 Fehler) vor dem Rendern.
Workflow (in dieser Reihenfolge erledigen)
| # | Schritt | Lesen | Ausgabe |
|---|---|---|---|
| 1 | Grundgerüst erstellen | – | python engine/make_video.py new videos/<slug> |
| 2 | Skript planen + schreiben | docs/02-script-writing.md | videos/<slug>/script.md (360–470 Wörter, 7 Beats) |
| 3 | Visuelles planen | docs/03-visual-planning.md | Szenenliste: Erzähltext → Typ, Überschrift, Figur |
| 4 | Storyboard schreiben | docs/04-storyboard-reference.md | videos/<slug>/storyboard.json (oder meta.json + scenes.jsonl → assemble) |
| 5 | Validieren | – | python engine/validate_storyboard.py videos/<slug> → korrigieren bis 0 Fehler |
| 6 | Vorschau + Qualitätssicherung | docs/06-qa-checklist.md | make_video.py preview videos/<slug> → build/preview.png prüfen, korrigieren |
| 7 | Rendern | docs/05-production.md | make_video.py render videos/<slug> → output/<slug>.mp4 |
| 8 | Finale Qualitätssicherung | docs/06-qa-checklist.md | Punktzahl ≥ 85, alle MÜSSEN-Bedingungen erfüllt |
Kleines/lokales Modell? Befolge docs/07-small-model-playbook.md anstelle der Schritte 2–5. Es unterteilt die Arbeit in Einzel-Szene-Prompts.
Das 7-Akt-Skript (einprägen)
Aufhänger (≤ 22 Wörter: „X erklärt.“ / „Wie funktioniert X eigentlich?“ / überraschende Behauptung / nachvollziehbare Handlung) → Spannung (das Rätsel) → Wegweiser („Lasst uns folgen…“) → Hauptteil (3–6 Kapitel: Konzept → einfache Bedeutung → alltägliches Beispiel → Konsequenz; EIN fortlaufendes Beispiel mit einer benannten Person) → Wendung („Aber hier kommt der interessante Teil…“) → Zusammenfassung („Also merk es dir so.“ eine Zeile pro Kapitel) → Pointe (Bruchstücke, die den Aufhänger aufgreifen: „Ein Scan. Vier Beteiligte. Zwei Sekunden.“).
Szenenrezept (einprägen)
- 1 Szene = 1–3 Sätze (8–28 Wörter, 3–8 s); 20–32 Szenen pro Video.
- Wähle
visual.typeaus der Entscheidungstabelle indocs/03-visual-planning.md. Verwende 7–12 verschiedene Typen pro Video. - Zeige Hellboy in 40–70 % der Szenen (immer: erste Szene, Wendung, Zusammenfassung, letzte Szene). Verstecke ihn bei
sequence,hub,diagram,compare. - Baue große Diagramme über 2–4 Szenen mit
"continue": true+"shown": trueElementen und derselben Überschrift. - Überschriften 2–6 Wörter mit einem
*Betonungs*wort. Textlabels auf dem Bildschirm 1–4 Wörter.
Befehle (vom Repository-Rootverzeichnis aus)
# Zuerst aktivieren: source .venv/bin/activate | Windows: .\.venv\Scripts\Activate.ps1
python engine/make_video.py new videos/<slug> # Vorlagen
python engine/make_video.py assemble videos/<slug> # meta.json + scenes.jsonl -> storyboard.json
python engine/validate_storyboard.py videos/<slug> # muss 0 Fehler sein
python engine/make_video.py preview videos/<slug> # build/preview.png (1 Frame pro Szene)
python engine/make_video.py render videos/<slug> [--fast]
Beim ersten Mal auf einem Rechner: ./setup.sh (Linux/macOS) oder setup.ps1 (Windows). Fertige Videos landen in output/<slug>.mp4.
Referenzmaterial
examples/upi-explained/(warm-paper) undexamples/load-balancer-explained/(blueprint) — vollständige, durchgearbeitete Beispiele. Kopiere ihre Muster.templates/—script.template.md,storyboard.template.json.docs/01-style-bible.md— was der Referenzkanal tut, gemessen (warum die Regeln existieren).engine/icon_names.txt— alle 2.359 erlaubten Symbolnamen (Lucide).