Communitygithub.com

C4KEBX/motionexplainers

Verwenden, wenn der Benutzer darum bittet, ein 60-sekündiges vertikales animiertes Erklärvideo über Finanzen, Investitionen oder Geschichte in diesem Repository zu erstellen, zu skripten oder zu produzieren („Erstelle ein Video über X“, „/make-explainer <Thema>“). Führt Recherche, belegte Fakten, ein validiertes Storyboard, eine menschliche Überprüfungsphase und den finalen vertonten Render durch.

Was ist motionexplainers?

Dieser Skill (C4KEBX/motionexplainers) ermöglicht es einem KI-Agenten (wie Claude Code), aus einem beliebigen Thema ein vollständiges, 60-sekündiges, vertikales Erklärvideo im Format 1080×1922 zu erstellen. Der gesamte Workflow ist in sieben klar definierte Schritte unterteilt: Briefing, Recherche, Faktenprüfung, Storyboard-Erstellung, automatisierte Prüfung, eine menschliche Überprüfungsphase und schließlich die Produktion des Videos. Besonders wichtig ist die strikte Einhaltung der Qualitätsregeln: Jede im Video gezeigte Zahl, jedes Datum und jedes Zitat muss durch eine tatsächlich geöffnete und gelesene Quelle in einer `facts.json` belegt sein. Der Agent darf keine Zahlen aus dem Gedächtnis nennen oder unbelegte Behauptungen aufstellen. Der Skill ist für die Arbeit mit diesem spezifischen Repository ausgelegt und nutzt dessen Skripte (`npm run verify-facts`, `npm run check`, `npm run produce`), um die Konsistenz zwischen Fakten, Storyboard und der endgültigen Videodatei sicherzustellen. Nach der automatischen Prüfung muss der Agent anhalten und auf die Freigabe durch den Benutzer warten, bevor das finale Video gerendert wird.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/C4KEBX/motionexplainers/tree/HEAD/.claude/skills/make-explainer

In Ihrer bevorzugten KI fragen

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

Dokumentation

Ein 60-sekündiges Erklärvideo erstellen

Verwandle ein Thema mit der Pipeline dieses Repos in ein fertiges 1080x1920-Video. Es kostet nichts: Du erledigst die Recherche, das Schreiben und die Reparatur; die Skripte prüfen und rendern. Arbeite vom Root-Verzeichnis des Repos aus. Lies .claude/skills/make-explainer/rules.md, bevor du ein Storyboard schreibst.

Harte Regeln

  • Jede Zahl, jedes Datum, jeder Name und jedes Zitat auf dem Bildschirm stammt aus einem Fakt in facts.json, dessen Quelle du tatsächlich mit WebFetch geöffnet hast. Gib niemals eine Zahl aus dem Gedächtnis ein. Wenn du eine Behauptung nicht belegen kannst, streiche sie. Der Sprechertext sagt nur das, was eine von dir geöffnete Seite aussagt; füge keine Hintergrundbehauptungen hinzu, die du nicht gelesen hast.
  • Bearbeite niemals src/, tests/, die Validatoren oder diesen Skill, um ein Storyboard zu bestehen. Korrigiere das Storyboard oder die Fakten. Ändere niemals die Daten eines Facts, um sie einem Storyboard anzupassen, oder umgekehrt, ohne die Quelle erneut gelesen zu haben.
  • STOPP an der Überprüfungsphase (Schritt 6). Führe npm run produce erst aus, wenn der Benutzer das Überprüfungsblatt genehmigt hat.
  • Finanzen und Investitionen sind bildend und historisch: keine Ratschläge, keine Prognosen, kein „Du solltest“. Nenne den Zeitraum und die Quelle für jede Zahl.

Arbeitsablauf

Alles für ein Video befindet sich in videos/<slug>/ (Kleinbuchstaben, Ziffern, Bindestriche): facts.json, storyboard.json, review/.

  1. Briefing. Lege das Thema, einen Ein-Satz-Anspruch, den das Video beweist, und die Zielgruppe fest. Stelle nur eine Frage, wenn der Anspruch unklar ist. Standardstimme en-US-AndrewNeural, Musik null.
  2. Recherche. WebSearch, dann WebFetch primäre Quellen (BLS, Federal Reserve, SEC, Unternehmenseinreichungen; Wikipedia oder Museums- und Bibliotheksseiten für historische Daten). Kopiere Zahlen von der Seite. Schreibe 5 bis 8 Fakten: id, claim (ein vollständiger Satz mit Einheiten und Zeitraum, wie die Quelle ihn angibt), value für eine Zahl oder dataset für die genauen Daten, die ein Diagramm oder eine Liste zeigt, und source mit Name und URL. Lasse niemals Formulierungen wie „Beispieldaten“ in einem Anspruch stehen.
  3. Überprüfen. npm run verify-facts -- --facts videos/<slug>/facts.json --out videos/<slug>/verify.json. Öffne für jedes not-found, partial oder unreachable die Quelle erneut, korrigiere oder entferne das Fakt. Das Tool ist beratend; Du trägst die Verantwortung für die Genauigkeit. Eine kleine ganze Zahl (8, 9, 27) erscheint auf fast jeder Seite, daher sagt supported wenig aus: lies die Quellzeile selbst. Wenn du facts.json aus irgendeinem Grund bearbeitest, führe verify-facts erneut aus; das Überprüfungsblatt markiert ein veraltetes Ergebnis.
  4. Skript und Storyboard. Insgesamt etwa 155 Wörter Sprechertext (55 bis 60 Sekunden), 6 bis 10 Szenen, ein Aufhänger in Szene 1, eine Idee pro Szene, abwechslungsreiche Szenentypen (niemals drei gleiche hintereinander). Verwende storyboard.schema.json für genaue Felder und Grenzen und kopiere die Form von fixtures/finance.storyboard.json, fixtures/history.storyboard.json und fixtures/ancient.storyboard.json. Schreibe videos/<slug>/storyboard.json.
  5. Prüfen und reparieren. npm run check -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json. Behebe jedes Problem (jede Nachricht nennt die Szene und die Lösung) und führe es erneut aus, maximal 6 Durchläufe; wenn etwas immer noch blockiert, berichte genau, was. Behandle Warnungen (Länge, Formulierungshinweise, nicht zurückverfolgter Text) als Dinge, die zu beheben oder zu rechtfertigen sind. Die Längenschätzung ist auf etwa 10 Prozent genau (reale Wörter pro Sekunde lagen zwischen 2,5 und 3,2), also ziele auf 55 bis 60 s; produce ist die Autorität und eine abgelehnte Länge bedeutet nur, den Sprechertext anzupassen und erneut auszuführen.
  6. Überprüfungsphase. npm run sheet -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json --verify videos/<slug>/verify.json --out videos/<slug>/review. Sage dem Benutzer, er solle videos/<slug>/review/review.html öffnen. Fasse zusammen: den Anspruch, die Szenenliste, die Wortanzahl und die geschätzte Länge, jeden Fakt mit seiner Quellenprüfung und jede Warnung. Frage nach Genehmigung oder Änderungen. STOPP und warte.
  7. Produzieren. Nach der Genehmigung: npm run produce -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json --out out/<slug>. Es dauert etwa zwei Minuten. Wenn die Länge abgelehnt wird oder eine Szene zu kurz ist, ändere den Sprechertext, führe check erneut aus, produziere erneut (Sprachaudio wird nach Text zwischengespeichert). Melde den Dateipfad, die Länge und die Lautstärke. Sage klar, was du nicht beurteilt hast: Stimmqualität, Aussprache, Tempo und Geschmack. Bitte den Benutzer, es sich anzusehen.

Wenn etwas schief geht

  • Eine Prüfnachricht, die du nicht verstehst: sie nennt eine Szenen-ID; öffne diese Szene in rules.md für ihre Grenzen. Rate nicht bei der Lösung.
  • Der Fakt und die Szene stimmen nicht überein: öffne die Quelle erneut. Korrigiere das, was falsch ist, anhand der Quelle, niemals durch Kopieren von einem auf das andere.
  • Eine Kartenregion wird nicht gefunden: verwende die im Atlas vorgeschlagene Schreibweise („Vereinigte Staaten von Amerika“); Regionen müssen das focus-Feld überlappen.
  • Stimmprobleme (Netzwerk): npm run produce benötigt Internet für Edge TTS; --voice standin gibt einen fast stummen Platzhalter-Audio für einen Testlauf nur.
  • Fehlende Einrichtung: führe npm install und npm run setup:tts einmal aus.

Ausgabe an den Benutzer

Halte es kurz: den Dateipfad, was das Video behauptet, Länge, Lautstärke, die verwendeten Fakten und Quellen sowie alle Warnungen, die du akzeptiert hast, und warum.

Verwandte Skills