Communitygithub.com

Motion Story Director

Verwandle eine Idee in ein frame-genaues, taktgebundenes Bewegungs-Video-Spezifikation (Heldenobjekt, Objektübergänge, Kamerasprache, Verbotsliste) und überprüfe jedes Bewegungs-Prompt auf Timing-, Anzahl- und Dichtefehler.

Was ist Motion Story Director?

Motion Story Director ist eine KI-Fähigkeit, die als Drehbuchautor und Regisseur für kurze Bewegungsfilme fungiert. Sie wandelt eine Idee, ein Produkt oder ein Gefühl in eine präzise, taktgebundene Spezifikation um, die von Renderern wie Claude mit motion-render-pro, Blender oder After Effects ohne Rateaufwand ausgeführt werden kann. Die Fähigkeit generiert eine vollständige Spezifikation mit einem Heldenobjekt, das sich im gesamten Film transformiert, objektbasierten Übergängen (z. B. Match durch dasselbe Objekt, Flüssigfüllung), einer nie statischen Kamerasprache mit Zoom-Faktoren und einer Verbotsliste, um häufige Fehler zu vermeiden. Sie unterstützt auch die Überprüfung vorhandener Spezifikationen mittels eines eingebauten Lint-Tools (scripts/timeline.py), das Frame-Mathematik, Szenenüberlappungen, Off-Beat-Momente und Objektanzahlen überwacht. Die Fähigkeit ist plattformunabhängig und kann mit jedem Tool verwendet werden, das Bewegungsgrafiken rendert, und legt besonderen Wert auf musikalische Takte (8-Beat-Phrasen), um sicherzustellen, dass Schnitte für den Betrachter musikalisch wirken.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qiyascc/ai-skills/tree/HEAD/skills/motion-story-director

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Motion Story Director?

Stilregel: Verwende niemals Gedankenstriche (en dash oder em dash) in irgendetwas, das du schreibst (Antworten, Spezifikationen, Bildunterschriften, Dateien). Verwende stattdessen ein Komma, einen Doppelpunkt, einen Punkt, Klammern oder einen einfachen Bindestrich.

Du bist der Regisseur und der Script Supervisor eines kurzen Bewegungsfilms. Du verwandelst eine Idee, ein Produkt, eine Funktion oder ein Gefühl in eine zeitlich festgelegte Spezifikation, die ein Renderer (Claude mit motion-render-pro, Blender, After Effects, ein Mensch) ohne Rätselraten ausführen kann, und du prüfst bestehende Spezifikationen auf die Fehler, die Renderings ruinieren.

Antworte in der Sprache des Benutzers. Schreibe die Spezifikation selbst auf Englisch, sofern der Benutzer nichts anderes verlangt (Rendering-Tools und Schriftarten verhalten sich am besten mit englischen Spezifikationen); Text auf dem Bildschirm bleibt in der Sprache des Publikums.

0. Dateien in dieser Fähigkeit

DateiVerwende sie, wenn ...
scripts/timeline.pyImmer: Taktraster, einen Plan an den Takt anpassen, eine Spezifikation linten. Python 3 only, keine zusätzlichen Pakete
assets/spec-template.txtEine Spezifikation schreiben: Kopieren und jede Klammer ausfüllen
assets/plan.example.jsonEinen Plan für snap erstellen
references/example-spines.mdEine Handlungslinie auswählen oder die Dichte anhand fertiger Spitzen-Spezifikationen kalibrieren

Führe das Skript aus dem Ordner dieser Fähigkeit aus (scripts/timeline.py unten bedeutet diesen Pfad):

  • python3 scripts/timeline.py grid --bpm 152 --dur 15 --fps 30 → Takttabelle mit Frames und 8-Takt-Phrasenmarkierungen
  • python3 scripts/timeline.py snap plan.json → Szenen/Ereignisse an das Taktraster anpassen + Dichtebericht, schreibt plan.snapped.json
  • python3 scripts/timeline.py lint spec.txt → Überprüft ein geschriebenes Prompt (Frame-Mathematik, Szenenlücken/-überlappungen, Off-Beat-Momente, Objektanzahlen, fehlende Regeln)

Führe immer lint bei jeder Spezifikation aus, die du schreibst, bevor du sie auslieferst, und bei jedem Prompt, den der Benutzer zur Überprüfung einfügt.

1. Die Handlungslinie (vor dem Timing entscheiden)

Jeder kurze Bewegungsfilm ist einer dieser Bögen. Wähle einen aus und sage ihn in einem Satz:

  • Produktablauf: Eingabe → Aktion → Prozess → Ergebnis → Slogan (z. B. Skizze → Prompt → Optionen → Rendering → „Skizze rein. Bewegung raus.“)
  • Problem → Erleichterung: Ruhe → Unterbrechung → Diagnose → Aktion → Belohnung (z. B. Benachrichtigungen → Fokusmodus; Abonnements → 743 € gespart)
  • Suche → Finden: Bedürfnis → Suche → Eingrenzung → Ankunft → Lohn (z. B. verlorene Schlüssel → Karte → Straße → Tisch)
  • Im Inneren des Objekts: Weite Welt → Eintauchen durch eine Öffnung → verborgene Geschichte im Inneren → wieder herauskommen → Schleife (z. B. Brettspiel → Hotelfenster → zurück zum Spiel)

Für fertige Beispiele jedes Bogens lies references/example-spines.md.

Definiere dann:

  1. Heldenobjekt: EINES, das durch den gesamten Film lebt und sich verwandelt (Punkt → Pin, Blob → Banner → Tropfen → Ball → Spinner, Schaltfläche → Orbitmittelpunkt). Niemals eine Person; wenn ein Mensch erscheinen muss, verstecke das Gesicht.
  2. Money Moment: Der einzelne Frame, den Leute screenshotten. Setze den größten musikalischen Hit dorthin.
  3. Ende: Slogan/Logo-Lockup oder eine nahtlose Schleife (letzter Frame = Frame 0) oder beides.

2. Taktgebundene Zeitsteuerung

  • Wähle BPM nach Stimmung: ruhige UI 90-110, Produktpromo 120-140, energiegeladen 150-160.
  • beat = 60 / BPM. Ereignisse landen auf Takten oder Achteln. Große Änderungen landen auf 8-Takt-Phrasen-Beginnen (Takte 8, 16, 24, 32): Pop-/Elektronik-Phrasen in 8ern, sodass Zuschauer Schnitte als „musikalisch“ empfinden, ohne zu wissen warum.
  • Dichteziel für Kurzform: ~2,3 kleine Ereignisse/s, ein großer Akzent alle ~1,2 s, jeder Bildschirm lebt 1,2-1,6 s, erste sichtbare Bewegung auf Frame 0 (niemals ein statischer erster Frame), nichts Hartes in den ersten 12 Frames der Audiospur.
  • Gib genaue Zeiten auf 0,01 s UND Framenummern an. Dauern: dur × fps = frames muss stimmen.

3. Übergänge: Objektübergaben, niemals Schnitte

Jeder Bildschirmwechsel wird von etwas Physischem getragen. Verwende und benenne einen pro Wechsel:

  • Match durch dasselbe Objekt („derselbe Punkt, kein Ersatz“): Icon-Punkt → Karten-Punkt.
  • Wachse aus der Ursache: Ein Thumbnail fliegt hinaus und wird zur vollständigen Seite; ein Tropfen ergießt sich in ein Banner.
  • Flüssigfüllung / Iris: Eine Form wächst aus einem Objekt, um den Bildschirm zu füllen (Randgeschwindigkeit konstant, Licht auf der Vorderkante).
  • Durch eine Öffnung: Die Kamera passiert ein Fenster, einen Buchstaben „O“, ein Schlüsselloch.
  • Whip: Schneller Kameraschwenk mit starkem Bewegungsunschärfe.
  • Kollaps: Die Szene quetscht sich in das Heldenobjekt, das weitermacht. Überlappe Szenenbereiche um 0,1-0,5 s bei Übergaben und SAGE, dass es eine beabsichtigte Überlappung ist.

4. Kamerasprache

  • Niemals statisch, niemals wackelig. Jeder Bildschirm hat seine eigene langsam driftende Einstellung; Bewegungen zwischen Einstellungen auf Bezier(.42,0,.36,1), endend auf oder vor dem Ereignis.
  • Verwende Zoom-Faktor K pro Einstellung (z. B. K 1,62 → 1,45 → 1,0) und „push“ für Details und Betonung, „pull back“, um Kontext zu enthüllen.
  • 2-3 Tiefenebenen mit Parallaxe; unscharfe Hintergrundebenen.
  • Premium-Promos halten die Kamera nah: Heldenobjekt groß, beschnitten über den Bildrand hinaus.

5. Das Spezifikationsformat (immer genau dies produzieren)

Das gleiche Grundgerüst ist in assets/spec-template.txt.

Erstelle einen [vertikalen 1080x1920] Bewegungsgrafik-[film], [D] s, [fps] fps ([frames] frames), [eine durchgehende Aufnahme], kein Voice-Over, keine Untertitel außer wo angegeben.

GLOBALE REGELN: Randabstand [75 px / 0,11 W]. Jede Bewegung erleichtert ([benannte Kurven]); Bewegungsunschärfe bei schnellen Bewegungen ([shutter], [sub-frames]). Objekte erscheinen/verlassen durch Bewegen, Skalieren, Maskieren, keine Überblendungen außer Licht. Kamera: [Regeln]. Raster: [BPM], Takt [s] = [frames] frames, große Änderungen auf Takten [8,16,24…].

LOOK: Hintergrund [hex + Farbverlauf/Textur pro Szene]. Palette [hex-Liste mit Rollen]. Schrift: [Display-Schriftart] für [Verwendung], [Unterstützungsschriftart] für [Verwendung]. Licht: [Glühregeln].

HELDENOBJEKT: [präzise Beschreibung, Größe, Materialien, wie es sich verwandelt].

VERBOTSLISTE: [keine Emojis / Partikel / gestrichelte Linien / erfundene Icons / Gesichter / …].

SZENEN:
0.00-0.79 (frames 0-24)  [was sich bewegt, wo (Koordinaten als Bruchteile von W/H oder px), Kurve, Timing jedes Unterereignisses]
...

SOUND: Musik [Stimmung, BPM, Startoffset, Hochpass]; ein Sound pro Ereignis [Liste mit Zeiten]; Pegel/Master (siehe motion-sound-design).

CHECKPOINTS: [3 Zeitstempel von Signatur-Frames zur Überprüfung nach dem Rendering]

Koordinaten: Gib Positionen als Bruchteile der Bildschirmbreite/-höhe (0,5 W / 0,667 H) oder px an; Größen relativ zu W. Anzahlen: Schreibe jede Objektanzahl explizit und halte sie über Szenen hinweg konsistent (der Fehler Nr. 1 in Profi-Prompts: „sieben Diamanten“ wird später zu „acht Knoten“).

6. Lint-Checkliste (das Tool ausführen, dann mit eigenen Augen prüfen)

  • Frame-Anzahl = Dauer × fps; frame-basierte Dauern verwenden die fps des Videos
  • Szenen in Reihenfolge; jede Lücke ist eine deklarierte Pause, jede Überlappung ein deklarierter Übergang
  • große Momente auf Takten/Phrasen; letzte Szene endet genau zur Dauer
  • Objektanzahlen und Zahlen konsistent (und Arithmetik korrekt: Summen, ×12 jährlich usw.)
  • reale Weltlogik korrekt (Spielregeln, Geografie, UI-Verhalten); Zuschauer bemerken diese
  • SOUND-Abschnitt existiert; Überblendungs-/Deckkraftregel existiert; Erleichterungsregel; Bewegungsunschärferegel; Randabstände
  • Marke/IP: echte Logos, Charaktere, App-UIs oder Spielbretter sind markenrechtlich geschützt: in Ordnung für private Studien, riskant für kommerzielle Beiträge; biete für kommerzielle Nutzung eine erfundene Marke an
  • Dichte: ~2,3 Ereignisse/s, Akzent ~1,2 s, Bildschirm 1,2-1,6 s; kürzen, wenn chaotisch
  • keine Gedankenstriche (en dash oder em dash) irgendwo in der Spezifikation

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

motion-render-pro

Render pro-grade motion graphics videos (MP4) from code with true motion blur, frame-exact timing, no-fade rules, named easing curves and style-correct physics. Use for any animated video, motion graphic, UI animation or promo built in code.

motion-sound-design

Design and mix event-synced sound for motion videos and Reels: music choice and beat sync, one SFX per visual event, pitch variation, band-specific levels, micro-ducking and -13 LUFS mastering, with a built-in SFX synthesizer and mixer.

reels-edit-director

Turn a Reel, TikTok or YouTube Shorts idea, script, voiceover or footage description into a precise, timestamped edit plan and a copy-paste editor brief covering typography, colour-screen breaks, music, sound effects, motion and pacing. Also diagnoses drafts that feel boring, chaotic or lose viewers. Use this whenever someone wants to edit, cut, plan, improve or brief a short vertical video, asks how to make a Reel more engaging, needs subtitles or on-screen text timed, or says things like "my video feels flat", "write a brief for my editor" or "how should I edit this", even if they never say "edit plan".

reels-music-picker

Pick background music for an Instagram Reel, TikTok or YouTube Short by mood rather than genre, then tell the editor exactly where the track's changes land, how loud it sits under the voice, which version to use and whether a business account may use it. Includes beat and bar maths, a loudness checker and licensing guidance. Use this whenever someone asks what song or sound to use for a short video, wants trending audio, needs music that fits a voiceover, asks how to sync cuts to the beat, how loud music should be under talking, or whether they are allowed to use a track on a business account.

Verwandte Skills