Communitygithub.com

MotionCraft — Universelle Agenten-Fähigkeit für animierte Erklä…

Erstelle kinoreife Erklärvideos & Shorts (9:16 & 16:9, 15 Sek. bis 10 Min.) in 16 visuellen Kategorien auf Studioniveau: 3D, Isometrisch, Hausaufriss, 3D-Strichmännchen, Astronomie (GLSL Black Hole), Tierwelt, Meer 3D, Wissenschaft & Natur, Geschichte, Karten (Natural Earth d3-geo), Islamisch, Geografie, Anatomie, Volksmärchen, Cartoon & 2D-Animation. Generiert visuelle Empfehlungen, schrittweise Drehbücher (Hook → Szene 1..N), eigenständige HTML-Dateien, ZIP-Quellpakete und deterministische MP4-Videorenderings. Verwende diese Fähigkeit immer, wenn ein Benutzer ein Animationsvideo, ein Bildungs-Shorts, ein Erklärvideo, eine 3D-Simulation, eine historische/geografische Karte, 3D-Strichmännchen, Anatomie oder ein Video-Storyboard anfordert.

Was ist MotionCraft — Universelle Agenten-Fähigkeit für animierte Erklä…?

MotionCraft ist eine universelle KI-Agenten-Fähigkeit (für Claude Code, Cursor, Codex etc.), die eine einzelne Story-Idee in professionelle animierte Erklärvideos und Shorts verwandelt – komplett ohne externe Abhängigkeiten. Die Fähigkeit deckt 16 visuelle Kategorien ab, darunter 3D, Isometrisch, Hausaufriss, Astronomie, Tierwelt, Karten und 2D-Animation. Sie generiert automatisch eine visuelle Empfehlung (Objekte, Kamera & Atmosphäre), ein schrittweises Drehbuch (Hook → Szene 1..N) und eigenständigen HTML-Code (`<slug>.html`), der doppelgeklickt in jedem Browser abgespielt werden kann – inklusive Umschalter für das Seitenverhältnis (9:16 ↔ 16:9) und WebAudio-Soundeffekten. Zusätzlich erstellt sie ein ZIP-Quellpaket und kann mit einem optionalen Headless-Browser deterministische MP4-Videos rendern. Der generierte Code ist zu 100% deterministisch (keine Zufallszahlen, keine Zeitfunktionen) und läuft ohne npm-Abhängigkeiten – lediglich Node.js wird zum Bauen benötigt. Als Fallback für Agenten ohne Terminal-Zugriff kann die HTML-Datei auch direkt aus einer Vorlage zusammengesetzt werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alpianreza/motion-craft/tree/main

In Ihrer bevorzugten KI fragen

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

Dokumentation

MotionCraft — Universelle Agenten-Fähigkeit für Erklärvideos & Shorts in 16 Kategorien

Eigenständige Fähigkeit (keine App-Abhängigkeit), die einen einzigen Satz einer Story-Idee in visuelle Richtungsempfehlung, schrittweises Drehbuch (HOOK → SZENE 1 → SZENE 2 → usw. bis zu 10 Minuten), eigenständige Datei <slug>.html (Doppelklick, läuft sofort im Browser – komplett mit Umschalter für Seitenverhältnis 9:16 ↔ 16:9 & WebAudio-SFX), Quellpaket <slug>-source.zip sowie Video-Rendering .mp4 verwandelt.


Verbindlicher Workflow (5 Schritte)

Schritt 1 — Visuelle Empfehlung & Drehbuchplan (HOOK → SZENE 1..N)

Wenn der Benutzer eine Story-Idee liefert (falls Seitenverhältnis oder Dauer nicht genannt, verwende Standard 9:16 Shorts 30–45 Sek. für kurze Fakten oder 16:9 Video 60–600 Sek. für tiefgehende Themen):

  1. Wähle 1 passendste Kategorie aus den 16 Offiziellen Kategorien: 3D · Isometrisch · Hausaufriss · 3D-Strichmännchen · Astronomie · Tierwelt · Meer · Wissenschaft & Natur · Geschichte · Karten · Islamisch · Geografie · Anatomie · Volksmärchen · Cartoon · 2D-Animation.
  2. Formuliere spezifische visuelle Empfehlung:
    • Objekte & Requisiten (objek): Hauptsubjekt mit Textur/Gelenken + mindestens 3 maßstabs-/beweisvergleichende Requisiten.
    • Kamera & Übergänge (kamera): Multi-Shot-Muster (totale → Detail-Nahaufnahme → Orbit / whipTo / pull-back).
    • Atmosphäre & Beleuchtung (suasana): Himmels-/Raumatmosphäre, Nebel/Volumetrisches Licht, Farbpalette und Erzählton.
  3. Erstelle schrittweises Drehbuch (0 bis DUR Sekunden ohne Lücken):
    • Erster Teil Zwingend HOOK (3–10 Sekunden, Eröffnung, die Neugier weckt).
    • Fortgesetzt mit SZENE 1, SZENE 2, usw., abgeschlossen mit einer starken, faktenbasierten Schlussfolgerung (~2,2 Wörter/Sekunde).
    • Für lange Dauern (> 60 Sek. bis 600 Sek. / 10 Min.), lies Leitfaden für lange Formate (10 Min.).

Schritt 2 — Lies das Kategorienrezept & die goldenen Code-Standardbeispiele (ZWINGEND!)

Schreibe sceneCode NICHT aus bloßer Spekulation! Bevor du Animationscode schreibst:

  1. Lies die Kategorientabelle & style-ID im Katalog der 16 Kategorien sowie die Laufzeitfunktionsliste in der Engine v4 API Referenz (MF).
  2. Lies die offiziellen Quellcode-Beispiele, die deinem Fall am nächsten kommen, in den Goldenen Code-Standardbeispielen.
  3. Qualitätsgleichheitsgesetz: Objektdichte, Detailtextur (CanvasTexture / geschichtetes SVG / Küstenlinie world-atlas / GLSL-Shader), Beleuchtung und Kameragleitfähigkeit MÜSSEN DEN BEISPIELEN IN golden-showcases.md ENTSPRECHEN. Es ist verboten, einfache Kästchen/Kreise ohne Textur oder Requisiten zu zeichnen!

Schritt 3 — Goldene Regeln für das Schreiben von sceneCode

sceneCode wird als Funktionsrumpf (MF, stage, tl, W, H, DUR) ausgeführt:

  • Doppelt responsiv (9:16 Shorts & 16:9 Video): Verwende immer die Proportionen von W und H (W * 0.5, H * 0.45, size: W < H ? 50 : 56, labelX: W < H ? W * 0.08 : W * 0.54), damit die Animation ohne Abschneiden sowohl auf 1080×1920 als auch auf 1920×1080 vollständig dargestellt wird.
  • Überschreibe nicht die Variable H: Schreibe niemals const { H } = MF; da dies die Bühnenhöhe H überschreibt! Rufe immer über das Präfix MF. auf (MF.H, MF.S, MF.T).
  • 100% deterministisch: Verwendung von Math.random(), Date.now(), setTimeout oder setInterval ist verboten. Verwende MF.rng('fester-seed'), Tweens auf tl und MF.onTick((t) => ...) als reine Funktionen der Zeit t.
  • Frame 0 sofort aktiv: Bühnenelemente & der Eröffnungstitel HOOK MÜSSEN at: 0 verwenden, damit der erste Frame nicht leer/dunkel ist.
  • Anti-PowerPoint: Maximal 1 Schlagzeile (MF.highlightHeadline) + 1 Callout/Zahl (MF.leaderCallout / MF.bigStat) gleichzeitig. Die Geschichte MUSS durch Veränderungen von Welt-/Objektaktionen und Kamerabewegungen getragen werden, nicht durch eine Aneinanderreihung von Textkarten!

Schritt 4 — Erstelle die eigenständigen Dateien (.html, -source.zip, -drehbuch.md)

Erstelle eine JSON-Spezifikationsdatei (z.B. spec.json):

{
  "title": "Videotitel",
  "idea": "Ursprüngliche Story-Idee des Benutzers",
  "style": "stickman-3d",
  "aspectRatio": "9:16",
  "duration": 30,
  "visualRecommendation": {
    "objek": "...",
    "kamera": "...",
    "suasana": "..."
  },
  "scenes": [
    { "label": "HOOK", "title": "...", "start": 0, "end": 7, "narration": "...", "visualBeat": "..." },
    { "label": "SZENE 1", "title": "...", "start": 7, "end": 18, "narration": "...", "visualBeat": "..." }
  ],
  "sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); ..."
}

Führe dann das eigenständige Build-Skript aus (reines Node.js, 0 npm-Abhängigkeiten!):

node "<pfad-zur-faehigkeit>/scripts/build.mjs" --spec pfad/zu/spec.json --out-dir zielverzeichnis

Dieses Skript validiert die Syntax & Determiniertheit von sceneCode, bettet ./assets/motion-engine.js, ./assets/sfx-synth.mjs sowie ./assets/land-110m.json (falls Karten verwendet werden) ein und erzeugt:

  1. <slug>.html — 1 eigenständige Datei, bereit zur Wiedergabe in jedem Browser (Auto-Loop + Scrub-Leiste + Umschaltknopf 9:16 ↔ 16:9 + WebAudio-SFX).
  2. <slug>-source.zip — vollständiges Quellcode-Archiv (index.html, src/scene.js, src/project.json, DREHBUCH-UND-STORYBOARD.md, engine/).
  3. <slug>-drehbuch.md — übersichtliches Drehbuch- & visuelles Empfehlungsdokument.

Fallback ohne Shell / Web-Chat: Falls die Agentenumgebung keinen Terminal-Zugriff auf Node.js hat, kopiere den Inhalt von ./assets/starter-template.html, ersetze die Platzhalter /*__MOTION_ENGINE__*/, /*__SFX_SYNTH__*/ und /*__PROJECT_JSON__*/ null direkt, um eine vollständige index.html-Datei zu erzeugen.

Schritt 5 — Frame-Überprüfung & MP4-Videoexport (Optional / Nur wenn Headless-Browser verfügbar)

Falls die Umgebung Chrome/Edge + puppeteer-core (oder puppeteer) bereitstellt, führe eine automatische Überprüfung durch, um 0 Laufzeitfehler sicherzustellen und Screenshots zu prüfen:

# Schnelle Überprüfung (prüfe 0 Fehler + speichere Screenshots von HOOK & Mitte):
node "<pfad-zur-faehigkeit>/scripts/export-mp4.mjs" --html zielverzeichnis/<slug>.html --verify-only

# Vollständiges Rendern zu MP4-Video (H.264 + AAC SFX automatisch, optional + --vo narration.mp3):
node "<pfad-zur-faehigkeit>/scripts/export-mp4.mjs" --html zielverzeichnis/<slug>.html --fps 30 --scale 1

Wenn Fehler oder überlappender Text in den Überprüfungs-Screenshots auftreten, korrigiere sceneCode, baue mit scripts/build.mjs neu und lege das Ergebnis dem Benutzer vor.

Verwandte Skills