Communitygithub.com

Erklärvideo

Erstelle 2–3-minütige vertikale (9:16) Technik-Erklärvideos für Nicht-Techniker, präsentiert vom Cartoon-Architekten „Hellboy“, im Stil der Referenzreels (Kapitelverfolger, Aufbaudiagramme, Karaoke-Untertitel, lippensynchronisierte Figur, indisch-englische Stimme). Verwende dies, wenn du aufgefordert wirst, ein Erklärvideo / Reel / Kurzvideo zu einem beliebigen technischen Thema zu erstellen, zu skripten, zu storyboarden, zu rendern oder zu verbessern.

Was ist Erklärvideo?

Dieses Skill ermöglicht es KI-Agenten (wie Claude Code, Cursor, Codex), aus einem einzelnen technischen Thema ein vollständiges, produktionstaugliches Erklärvideo im vertikalen 9:16-Format (1080×1920, MP4) zu generieren. Das Video ist für ein nicht-technisches Publikum konzipiert und folgt einem strengen 7-Akt-Skriptschema (Hook, Spannung, Roadmap, Hauptteil, Wendung, Zusammenfassung, Pointe). Der visuelle Stil, das Tempo und die Skriptstruktur sind von einem Referenzkanal übernommen, enthalten aber eine eigene Cartoon-Figur (Hellboy) sowie eine festgelegte indisch-englische Sprachausgabe. Der Agent erledigt die gesamte Arbeit, ohne Rückfragen zu stellen: Er erstellt ein Grundgerüst, schreibt ein Skript (360–470 Wörter) und ein detailliertes storyboard.json, validiert die Ausgabe, erstellt eine Vorschau und rendert das finale Video. Dabei müssen strenge Regeln eingehalten werden: Hellboy darf nur aus einer festen Quelldatei bezogen werden, die Sprachausgabe ist unveränderlich, die Videolänge muss zwischen 2:00 und 2:50 Minuten liegen, und jede einzelne Szene muss eine sichtbare Änderung auf dem Bildschirm bewirken. Das Skill ist für Entwickler und fortschrittliche KI-Agenten gedacht, die automatisiert ansprechende Technikerklärungen für soziale Medien oder interne Schulungen produzieren möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bhuvanchandmaddi/video-generator-skill/tree/HEAD/skills/explainer-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

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:

  1. Erstelle einen Slug aus dem Thema (wie-dns-funktioniert) und führe python engine/make_video.py new videos/<slug> aus.
  2. Schreibe videos/<slug>/script.md (docs/02), dann videos/<slug>/storyboard.json (docs/03 + docs/04). Kopiere Muster aus examples/upi-explained/.
  3. Führe python engine/validate_storyboard.py videos/<slug> aus. Korrigiere jeden FEHLER und wiederhole, bis 0 error(s) ausgegeben wird.
  4. Führe python engine/make_video.py preview videos/<slug> aus. Wenn du Bilder sehen kannst, überprüfe build/preview.png anhand von docs/06 Abschnitt B und korrigiere.
  5. Führe python engine/make_video.py render videos/<slug> aus. Antworte mit dem Pfad output/<slug>.mp4, der Dauer und einer 2-zeiligen Zusammenfassung.

Die unverhandelbaren Regeln

  1. Hellboy wird nie neu gezeichnet. Er kommt nur aus character/hellboy/hellboy.js. Du darfst show, arm (down/point/explain) und expression setzen, sonst nichts. Lies character/hellboy/CHARACTER_BIBLE.md einmal.
  2. Die Stimme ist fest in engine/config.json eingestellt. Ändere sie nicht pro Video.
  3. Länge: 360–470 Wörter Erzähltext, 2:00–2:50. Sätze ≤ 20 Wörter.
  4. Jeder Satz verändert etwas auf dem Bildschirm. Elemente erscheinen bei ihrem gesprochenen Stichwort ("at").
  5. Richtig ist besser als einfach. Vereinfache, indem du Dinge weglässt, niemals, indem du etwas Falsches sagst.
  6. Validator muss bestehen (0 Fehler) vor dem Rendern.

Workflow (in dieser Reihenfolge erledigen)

#SchrittLesenAusgabe
1Grundgerüst erstellen–python engine/make_video.py new videos/<slug>
2Skript planen + schreibendocs/02-script-writing.mdvideos/<slug>/script.md (360–470 Wörter, 7 Beats)
3Visuelles planendocs/03-visual-planning.mdSzenenliste: Erzähltext → Typ, Überschrift, Figur
4Storyboard schreibendocs/04-storyboard-reference.mdvideos/<slug>/storyboard.json (oder meta.json + scenes.jsonl → assemble)
5Validieren–python engine/validate_storyboard.py videos/<slug> → korrigieren bis 0 Fehler
6Vorschau + Qualitätssicherungdocs/06-qa-checklist.mdmake_video.py preview videos/<slug> → build/preview.png prüfen, korrigieren
7Renderndocs/05-production.mdmake_video.py render videos/<slug> → output/<slug>.mp4
8Finale Qualitätssicherungdocs/06-qa-checklist.mdPunktzahl ≥ 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.type aus der Entscheidungstabelle in docs/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": true Elementen 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) und examples/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).

Verwandte Skills