Communitygithub.com

Motion Educator

Erstelle hochwertige Erklärfilme (20–120 Sekunden) – im Quer- oder Hochformat – mit Storyboard, Voiceover, Musik und Soundeffekten, gerendert als MP4.

Was ist Motion Educator?

Motion Educator ist ein AI-Agenten-Skill zur Produktion professioneller Erklär- und Bildungsvideos, die komplett in Code gebaut und frame‑genau gerendert werden. Der Skill erzwingt einen strengen Workflow: Zuerst wird ein detailliertes Storyboard mit gezeichneten Frames erstellt und geprüft, bevor auch nur eine Zeile Filmcode geschrieben wird. Die Narration wird als durchgehender Monolog verfasst, mit ElevenLabs als Take aufgenommen und der Bildschnitt darauf abgestimmt. Unterstützt werden 3D-Objekte, Diagramme, Charts, Glasscheiben, Metal-Schrift und dynamische Szenen. Der Skill läuft auf Node.js mit Playwright, FFmpeg und Python 3 und eignet sich für Plattformen wie Claude Code, Cursor oder Codex. Typische Anwendungen sind Science-, Mathe-, Geschichts-, Finanz- oder Produktkonzept-Erklärungen. Der Skill priorisiert faktische Korrektheit mit Quellenangaben, überprüfbare Zahlen und eine unabhängige Qualitätskontrolle vor der Auslieferung.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zeative/motion-educator/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Motion Educator?

Du erstellst kurze Erklärfilme (20 bis 120 Sekunden, Querformat‑Erklärer oder Hochformat‑Shorts), die teuer aussehen und eine Sache gut vermitteln. Der Film ist eine Webseite mit einer pausierten Timeline: Jedes Bild wird durch Anspringen gezeichnet, sodass nie ein Frame verloren geht und jede Einstellung einzeln repariert und neu gerendert werden kann. Das Toolkit in diesem Skill ist diese Engine. Im Ordner examples/ findest du fertige Filme, die nach diesem Skill erstellt wurden, jeweils mit Storyboard, Quellcode, Cue‑Sheet und Narration: langit-biru (nur Untertitel, am meisten geprüft) und petir-guntur (ein vertonter Kurzfilm) sollten zuerst gelesen werden.

Lies nur die Referenz, die dein aktueller Schritt benötigt.

SchrittLese
Entscheiden, was gelehrt wird und in welcher Reihenfolgereferences/pedagogy.md
Storyboard schreiben und zeichnen (das Tor)references/storyboard.md
Look, Akzent, Bühnenlicht, 3D auswählenreferences/look.md
Film mit dem Kit bauenreferences/engine.md, dann references/motion.md
Narration schreiben: gesprochene Sprache, nicht Untertitel; Indonesisch und Englischreferences/narration.md
Die Stimme: auswählen, einen Take mit ElevenLabs aufnehmen, den Film darauf schneidenreferences/voice.md
Musik, Soundeffekte, der Mixreferences/sound.md
Rendering prüfen, unabhängige Überprüfungreferences/review.md
Rendern mit raea statt dem Browserreferences/raea.md

Was niemals gebogen wird

  1. Storyboard zuerst, und es wird gezeichnet. Keine Filmdatei wird geschrieben, bevor storyboard.json den Check kit/tools/storyboard.mjs mit null Fehlern besteht und die Person das Board gesehen hat. Jede Einstellung hat gezeichnete Frames (wie sie beginnt, was passiert, wie sie endet), skizziert in den Koordinaten des echten Frames, sodass der Bau direkt daraus geschnitten werden kann. Wenn die Person einen unbeaufsichtigten Durchlauf gewünscht hat, sende das Board und mache weiter; andernfalls warte auf ihr Ja.
  2. Wahr, mit Quellen. Jede Zahl und jede Behauptung auf dem Bildschirm steht im Faktenblatt des Storyboards mit ihrer Herkunft. Wenn du es nicht belegen kannst, sage es nicht. Was gezeichnet wird, stimmt mit dem Geschriebenen überein: Ein Balken, ein Messgerät oder ein Pfad, der für eine Zahl steht, wird aus dieser Zahl berechnet. Ein Diagramm, das nicht maßstabsgetreu ist, sagt dies auf dem Bildschirm. Eine Zahl erscheint zu ihrem Wert (kein Hochzählen durch Werte, die falsch sind).
  3. Es erklärt sich selbst stumm. Das Bild und die Worte auf dem Bildschirm tragen die Erklärung; die Stimme und der Sound lassen sie wirken. Ein Erstzuschauer ohne Ton kann sagen, was er gelernt hat. Der Schritt, auf dem die gesamte Erklärung beruht, wird als Mechanismus gezeichnet (was hineingeht, was es trifft, was herauskommt, wo es endet), niemals dem Untertitel allein überlassen.
  4. Eine Uhr. Jeder animierte Wert ist eine Funktion der Zeit der Timeline. Keine CSS-Animationen, keine requestAnimationFrame-Schleifen, kein Date.now(), keine ungesetzte Zufälligkeit.
  5. Das Storyboard ist die Quelle der Zeit. Der Film liest Einstellungsanfänge und -enden aus storyboard.json; Untertitel und die Kapitelleiste werden daraus generiert. Ändere den Plan dort, niemals von Hand im Film. In einem Film, der spricht, schreibt der aufgenommene Take diese Zeiten (voice.mjs).
  6. Du benottest deine eigene Arbeit nicht. Standbilder jeder Einstellung werden vor einem vollständigen Rendering betrachtet, Messungen werden am Rendering durchgeführt, und ein neuer Prüfer, der den Film nicht gebaut hat, bewertet das Ergebnis (references/review.md).
  7. Ein Film, der spricht, wird als gesprochene Sprache geschrieben und als ein Take aufgeführt. Das Skript wird vollständig geschrieben und laut gesagt, bevor es eine Einstellung gibt; es wird einmal durchgängig aufgeführt, und das Bild wird auf die Stimme geschnitten. Niemals ein Satz pro Einstellung, niemals eine Aufnahme pro Satz, niemals eine Pause, die an einen Plan angepasst wird.
  8. Sage, was nicht geprüft wurde. Du kannst nicht hören. Sage, dass der Mix durch Messung eingestellt wurde, nenne, worauf eine Person achten sollte, und liefere eine reine Musikversion neben dem Vollmix.

Arbeitsablauf

0. Ein Arbeitsbereich

Das Kit wird in das Projekt der Person kopiert, niemals aus dem eigenen Ordner des Skills verwendet.

node <skill>/kit/tools/new.mjs <workspace> <film-name>   # kopiert kit/ und package.json, falls nicht vorhanden, erstellt films/<film-name>/
cd <workspace> && npm install                            # three.js, GSAP, die Schriftarten
sh kit/audio/fetch.sh                                    # die Soundbibliothek (nicht eingecheckt: Lizenz)

Erfordert Node 20+, Playwright mit Chromium, FFmpeg und Python 3 mit numpy für den Mix. node kit/tools/doctor.mjs überprüft alles und sagt, was installiert werden muss. Füge --portrait zu new.mjs für einen Kurzfilm in 1080x1920 hinzu.

1. Brief (ein paar Zeilen, im Kopf des Storyboards)

Wer zuschaut, was sie bereits wissen, und das Versprechen: der eine Satz, den sie nach dem Anschauen sagen können. Ein Film, ein Versprechen. Wenn das Thema zwei Versprechen braucht, sind es zwei Filme. Wähle die Sprache, die das Publikum liest, das Format (Querformat für eine Lektion, Hochformat für einen Kurzfilm) und ob der Film spricht oder nur mit Untertiteln erklärt.

2. Recherche und das Faktenblatt

Liste jede Behauptung auf, die der Film aufstellen wird, jeweils mit ihrer Quelle, als facts in storyboard.json. Bevorzuge Primär- und institutionelle Quellen. Führe die Berechnungen selbst durch und zeige sie (eine Zahl wie „5,9x“ wird mit dem geschrieben, woraus sie berechnet wurde). Schreibe auf, was du vereinfachst, und entscheide, wie der Film ehrlich damit umgeht.

3. Das Skript, wenn der Film spricht

Folge references/narration.md: eine Frage, geschrieben als durchgehende Rede im eigenen Register des Publikums, laut gesagt und zeitlich gemessen, bevor es eine Einstellungsliste gibt. Dann schneide es in Einstellungen: voice jeder sprechenden Einstellung ist ihr Abschnitt des Skripts.

4. Das Storyboard: das Tor

Folge references/storyboard.md. Kurz: Akte, dann Einstellungen (etwa alle drei Sekunden ein neues Bild), jede Einstellung mit dem, was sie lehrt, ihrem Untertitel, was auf dem Bildschirm zu sehen ist, der Bewegung, was in die nächste Einstellung übergeht, dem Übergang, dem Sound, was zu prüfen ist, den Fakten, die sie zitiert, und zwei oder drei gezeichneten Frames. Schneide auf den Beat der Musik.

node kit/tools/storyboard.mjs films/NAME --png     # null Fehler, dann zeige films/NAME/storyboard/*.png

Sende die Seiten an die Person. Die Kontaktbögen (der gesamte Film in Frames) kommen zuerst.

5. Der Take, wenn der Film spricht

Folge references/voice.md: wähle eine Stimme aus, die die Sprache muttersprachlich beherrscht (lass die Person zwei oder drei hören, wenn du kannst), führe das gesamte Skript als einen Take auf und schneide den Film darauf. Die Zeiten des Storyboards sind von nun an die des Takes.

node kit/audio/voice.mjs films/NAME --script                       # der Take, der aufgeführt werden soll
node kit/audio/voice.mjs films/NAME --generate                     # mit einem API-Key: der Take und seine Wortzeiten
node kit/audio/voice.mjs films/NAME --take AUDIO --words WORDS     # mit einem Speech-Connector: beide zurückgeben
node kit/audio/voice.mjs films/NAME                                # die Zeit jeder Einstellung und die Wörter zum Anhören

6. Bauen, eine Einstellung nach der anderen

Folge references/engine.md. Gib jeder Einstellung ein <section class="scene"> und animiere sie zwischen s.sNN.start und s.sNN.end. Baue in der Reihenfolge des Storyboards und betrachte ein Standbild jeder Einstellung, sobald du sie fertiggestellt hast:

node kit/tools/render.mjs films/NAME --stills 1.5,4.2,7.9      # fertige Frames, ein paar Sekunden Arbeit

Vergleiche jedes Standbild mit seinem gezeichneten Frame. Was der Frame bei (x, y) platziert hat, ist bei (x, y).

7. Rendern

node kit/tools/render.mjs films/NAME                  # out/picture.mp4, in Vier-Sekunden-Segmenten
node kit/tools/render.mjs films/NAME --only 12-16     # nach einer Korrektur: nur die geänderten Segmente

Eine Minute Film bei 60 fps dauert etwa eine halbe Stunde auf vier CPU-Kernen. Führe es im Hintergrund aus und schreibe inzwischen das Cue‑Sheet.

8. Sound

Folge references/sound.md: ein Musikbett, auf dessen Beat die Schnitte bereits liegen, und kleine, saubere Effekte auf realen Ereignissen, geschrieben als films/NAME/cues.json. Ein für den Film komponiertes Bett (kit/audio/music.mjs) passt besser als ein Bibliothekstitel, wenn der Film veröffentlicht wird.

python3 kit/audio/mix.py films/NAME                   # out/NAME.mp4, Lautstärke an der fertigen Datei gemessen
python3 kit/audio/mix.py films/NAME --no-sfx --out films/NAME/out/NAME-music-only.mp4

node kit/tools/make.mjs films/NAME führt die Befehle der Schritte 4 bis 9 der Reihe nach aus (Prüfung, Stimme, Rendern, Mix, Messung, eine Teilkopie) und stoppt beim ersten Fehler. Es ersetzt nicht das Betrachten von Standbildern während des Bauens.

9. Prüfen, korrigieren, verifizieren

Folge references/review.md: node kit/tools/check.mjs films/NAME (Kontaktbögen, eingefrorene Zeit, Lautstärke), dann ein neuer Prüfer mit dem Film, dem Storyboard und den eigenen Worten der Person. Korrigiere die größten Lücken, rendere nur das Geänderte neu und lass einen neuen Prüfer die Liste verifizieren. Stoppe an der Qualitätsschwelle oder wenn die Verbesserungen kosmetisch werden. Wenn eine Korrektur ändert, was eine Einstellung zeigt, ändere das Storyboard entsprechend und zeichne das Board neu: Der Plan und der Film widersprechen sich nie.

10. Liefern

Das MP4 (H.264, 1080p60, etwa −14 LUFS, True Peak unter −1 dBFS), eine leichtere Kopie zum Teilen, die reine Musikversion, die Storyboard-Seiten und eine kurze ehrliche Notiz: was gemessen wurde, was nur angesehen wurde, worauf niemand gehört hat und was du als Nächstes tun würdest.

Die Dateien eines Films

films/NAME/
  storyboard.json     der Plan: Fakten, Akte, Einstellungen, gezeichnete Frames. Der Film liest seine Zeiten daraus
  storyboard.html     das Board (generiert), storyboard/*.png seine Seiten
  index.html          ein <section class="scene"> pro Einstellung oder Einstellungsgruppe
  film.css            die Stücke dieses Films, aufbauend auf kit/css/film.css
  film.js             die Timeline, gebaut mit kit/engine/motion.js
  cues.json           das Musikbett und jeder Ton, auf der Uhr des Films
  voice/              die Narration: take.mp3, die Zeit jedes Wortes, der Schnitt (voice.json), subtitles.srt
  out/                Renderings (niemals eingecheckt)

Arbeitsweise

  • Plane dort, wo die Person es sehen kann (das Board), dann baue, ohne bei jedem Schritt zu fragen.
  • Wenn die Arbeit länger dauert, sage in einem Satz, was du tust.
  • Zeige die Arbeit: das Board, Standbilder, Kontaktbögen, gemessene Zahlen, das Urteil des Prüfers.

Verwandte Skills