Communitygithub.com

jayfirke/motion-studio

Planen Sie einen Film als Regisseur und zeigen Sie dem Eigentümer eine abspielbare Previs-Seite (Animatic mit echter Stimme, Musik und Geräuschen, einer Zeitleiste, drei austauschbaren Optionen für jede Entscheidung, zeitverankerten Notizen, Versionen und einem Genehmigungs-Button), bevor etwas gerendert wird.

Was ist motion-studio?

Motion Studio ist ein KI-gestütztes Skill-System für die Vorproduktion von Filmen, das teure kreative Entscheidungen in die günstigste Phase verlagert. Es ermöglicht einem KI-Agenten (z. B. Claude Code oder Cursor) als Regisseur zu arbeiten: Story, Drehbuch, Storyboard, Styleframes, Animatic, Musik, Soundeffekte, Sprachausgabe, Engine-Wahl, Qualitätssicherung, Review, Versionen und Freigabe – alles in einem einzigen, festen React-/TypeScript-Preview-Studio. Der Eigentümer sieht eine vollständige, interaktive Previs-Seite mit Video-Player, Storyboard-Ansicht, Plan-Ansicht, Seitenvergleich, ⌘K-Suche, Anmerkungen, Kommentaren und einer strukturierten Überprüfung. Jede Entscheidung erhält standardmäßig drei echte Optionen (Richtung, Musik, Bewegung, Tempo, Kamera, Übergänge, SFX, Stimme). Das System vermeidet lange Fragebögen und inferiert aggressiv; nur echte Blockaden werden als Fragen gestellt. Sobald der Eigentümer die Previs genehmigt, wird eine `approved-video-spec.json` erzeugt, die an reine Rendering-Engines (HyperFrames, video-shotcraft, Remotion, etc.) übergeben wird. Der Kostenrahmen ist gering: eine 20-Sekunden-Previs kostet etwa 30–60 US-Dollar API-Äquivalent und benötigt keine Renderings.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jayfirke/motion-studio/tree/HEAD/.agents/skills/video-director-previs

In Ihrer bevorzugten KI fragen

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

Dokumentation

video-director-previs

Treffen Sie teure kreative Entscheidungen in der günstigsten Phase. Dieser Skill besitzt die Vorproduktion: Regie, Geschichte, Drehbuch, Storyboard, Styleframes, Animatic, Musik, Soundeffekte, Sprachausgabe, Engine-Wahl, Qualitätssicherung, Review, Versionen und Freigabe. Engines (HyperFrames, video-shotcraft, Remotion, motion-reel, bang-motion, Diffusion Studio) bauen nur das, was der Eigentümer genehmigt hat.

Arbeitsbeispiel: examples/crumb-previs/ (eine fiktive App zum Teilen von Rechnungen). Sein Datenpaket ist der Demofilm im Previs Studio (_shared/previs/studio/films/011-crumb/).

Die App ändert sich nie pro Film. Previs Studio ist eine feste React + TypeScript-App (Quelle _shared/previs/app/, siehe README). npm run build dort type-checkt, bündelt und bindet sie in _shared/previs/studio/index.html und _shared/previs/page/index.html (Vorlage); füge ein Ziel in scripts/inline.mjs für jede pro-Film-Seite hinzu. npm run smoke fährt die erstellte Seite in echtem Chrome auf Desktop, Tablet, Telefon und Vollbild (Screenshots mit --out). Bearbeiten Sie niemals manuell das erstellte index.html.

Was der Eigentümer bekommt: Ansehen (Video-Player mit echtem Vollbild, Hover-Scrub-Vorschau, Endkarte; Kommentarmodus, der den kleinsten Teil unter dem Zeiger benennt, scrollen für größer oder kleiner, ziehen Sie eine Box um mehrere Teile, Stift und Pfeil, ziehen Sie über die Aufnahmenzeile für einen Zeitbereich; Tonspuren mit Wellenformen, Beats, Duck-Kurve, Solo/Stumm/Lautstärke und ziehbaren Soundeffekten, die am Beat einrasten), Entscheidungen, die ihren Moment an Ort und Stelle mit Ton abspielen, Seitenvergleich, Halten zum Hören des Originals, Storyboard (Karten, die ihre Aufnahme an Ort und Stelle abspielen, Alle abspielen, Entscheidungen pro Aufnahme, ein Aufnahmeplan), Plan (Chefregisseur, Geschichte, Regieteam, Look, Ton, Assets, Produktion, Prüfungen, Versionen mit „Rückgängig anfragen“, Spezifikationsexport), eine geführte Überprüfung, Fragen Sie den Regisseur, ⌘K-Suche, Rückgängig/Wiederholen, helle und dunkle Designs, Tooltips auf jedem Steuerelement. Filme kommen nur als Datenpakete an.

Zwei Zuhause, gleiche App

  • Previs Studio (alle Filme): _shared/previs/studio/. Einen Film hinzufügen = films/<id>/previs.json + films/<id>/audio/... und eine Zeile in films.json hinzufügen. Lokal: python3 -m http.server --directory _shared/previs/studio (oder den Eintrag previs-studio in .claude/launch.json).
  • Pro-Film-Seite: projects/NNN/previs/page/ enthält eine Kopie desselben index.html (Titel <Produkt> Previs), films.json mit einer Zeile, deren path "" ist, previs.json und audio/.
  • Als claude.ai Artifact (nur Claude): Veröffentlichen Sie die Seite mit capabilities: {"db": {}, "user": {}, "sample": {}, "comments": {}, "downloads": true}. db speichert Notizen und Auswahlen, sample betreibt „Fragen Sie den Regisseur“, comments trägt „An Claude Code senden“, downloads den Spezifikationsexport. Ohne sie funktioniert die Seite immer noch und speichert im Browser.
  • Datenbank-Pfade: comments (Änderungsanfragen, die an den Film geheftet sind; die Sammlung behält den alten Namen) films/<id>/notes (kind frame, region, range, sound, shot, revert oder request; target, targets, box, strokes, quick Chips, t/t2, picks und version zum Zeitpunkt); Auswahlen und Sound-Tweaks films/<id>/state/picks (tweaks: <szene>.<sfx> {dt, db}, lane.vo|music|sfx {db}, mix.duck {on}); hinzugefügte Optionen films/<id>/state/custom; Genehmigung films/<id>/state/approval; Claudes Status films/<id>/state/claude; Aktivität films/<id>/state/activity; notes (freie Gedanken zum gesamten Film: lesen Sie sie als Hintergrund, niemals als Aufgaben) films/<id>/pad.

Libraries: mehr als drei Optionen auf Abruf

Jede Entscheidung liefert drei Regie-Optionen; D['libraries'] fügt mehr Optionen hinzu, die der Rezensent (oder der „Fragen“-Tab) einziehen kann: direction (Looks: Token-Sets + fonts_url), music (CC0-Betten mit bpm, phase, tags, level), motion (ease, spring {f,d} oder bezier), pacing, camera, transition, sfx (jeder Ton im Film) und voice (Fish-Stimmen: dir, durs, texts für andere Sprachen, intro, sample). Die globale voice-Entscheidung wählt den Erzähler; eine Stimme löst jede Zeile in <dir><szene>-<A|B|C>.mp3 auf, und eine Stimme mit needs und ohne dir spielt als Untertitel, bis sie aufgenommen ist. Hinzugefügte Optionen leben in der Seitendatenbank, sind rückgängig zu machen und gehen in die genehmigte Spezifikation ein. Bauen Sie Libraries mit examples/crumb-previs/libraries.py als Modell:

  • Musik: Durchsuchen Sie Freesound CC0 (freesound.py search ... --min-dur 20), freesound.py get, dann python3 _shared/previs/music_lib.py <page>/audio/music/lib <oggs> (beat-ausgerichtete 24 s Auszüge, gemessenes BPM); schreiben Sie Tags und ein „Warum“ pro Bett; Zeilen in _shared/ASSETS.md.
  • Stimmen: Wählen Sie öffentliche Fish-Stimmen mit search_voices (keine echten Personen oder Zeichen-Klone), listen Sie sie in voices/voices.tsv auf, schreiben Sie voices/lines-<lang>.txt, führen Sie voices/make_voices.sh aus (kostenloses Modell), dann überprüfen Sie Takes punktuell mit whisper-cli und generieren Sie alle, die Wörter fallen lassen, neu.
  • Der KI-Regisseur („Fragen“-Tab, lib/director.ts) kann auch Looks entwerfen (kontrastgeprüft, erlaubte Google Fonts), Bewegungsgefühle und neue Zeilenformulierungen (diese benötigen eine Aufnahme: es stellt eine Anfragenotiz für Claude Code).

Claude Codes Seite der Notizen (dies in jeder Runde tun)

Der Eigentümer sendet Notizen von der Seite („An Claude Code senden“: ein Live-Kommentar, der eine beobachtende Sitzung weckt, oder eine kopierte Nachricht). Dann: 0. Ziehen, bevor Sie ändern. Claude auf claude.ai kann einen „An Claude Code senden“-Thread selbst beantworten, die Datendatei bearbeiten und eine neue Version veröffentlichen. Lesen Sie vor dem Bauen das veröffentlichte previs.json, vergleichen Sie es mit Ihrem lokalen Build und übertragen Sie jede Änderung in build_previs.py, damit der nächste Build sie behält.

  1. Setzen Sie films/<id>/state/claude {state: "reading"|"working"|"publishing"|"idle", at, message, version, open}, damit die Seite zeigt, was Sie tun.
  2. Für jede offene Notiz: update Sie sie mit claude: {state:"seen"}, wenn gelesen, {state:"working"} während der Änderung, dann status:"done", claude:{state:"done", at, msg} und fügen Sie {by:"claude", text, at} zu replies hinzu (pin if_version). Verwenden Sie state:"question" (mit der Frage in msg), wenn Sie den Eigentümer brauchen, "wontfix", wenn Sie empfehlen, es zu belassen. Notizen mit kind:"request" sind Jobs vom „Fragen“-Tab (eine neue Zeile aufnehmen, einen Ton finden); prefer zeigt auf die Option, die der Eigentümer mag; intent:"question" will eine Antwort, keine Änderung. Jedes at ist die reale Zeit: nehmen Sie sie von date -u +%Y-%m-%dT%H:%M:%SZ, niemals eine Schätzung.
  3. Fügen Sie Zeilen zu films/<id>/activity hinzu ({at, by:"claude", kind:"seen"|"applied"|"published"|"question", text, version}): was Sie gelesen, geändert, veröffentlicht haben.
  4. Antworten Sie im Seitenkommentar-Thread, wenn der Eigentümer „An Claude Code senden“ verwendet hat, und lösen Sie ihn dann auf.

Regeln

  • Ein Regisseur, kein Komitee. Arbeiten Sie untenstehende Spezialisten-Checkliste selbst und in dieser Reihenfolge ab. Keine Workflows oder Unter-Agenten, es sei denn, der Eigentümer fragt (Kostenregel).
  • Aggressiv inferieren; nur echte Blockaden fragen (Produktwahrheit, ein fehlendes Asset, eine Lizenzfrage). Niemals ein langer Fragebogen, bevor der Eigentümer etwas sieht.
  • Drei Optionen für jede Entscheidung, standardmäßig. Richtung, Musik, Bewegungsgefühl, Tempo, und pro Szene: Übergang, Kamera, Stimme, jedes SFX-Ereignis. Optionen müssen sich echt unterscheiden. Markieren Sie die Wahl des Regisseurs und geben Sie jeder Option einen einfachen Satz zu Warum oder Kompromiss. „Nichts“ ist eine gültige SFX-Option.
  • Produktwahrheit. Jede Szene ist mit real_ui, conceptual_ui, conceptual_visual oder external_footage beschriftet; alles, was nicht real ist, zeigt ein Label im Player.
  • Hausregeln gelten weiterhin (AGENTS.md, OWNER.md): verbotene Klischees, Träger, zwei Textebenen, aufgenommene Foley, die Standardstimme, Lizenzen. Die Seite spielt nur CC0 oder selbst erstellte Audioinhalte; Mixkit (nur Rendering) erscheint nur namentlich.
  • Herunterskalieren. Ein 6-Sekunden-Sting kann eine Richtungskarte, 3 Musikoptionen und eine 6-Sekunden-Animatic sein. Ein 40-Sekunden-Produktfilm bekommt das volle Set.
  • Sperren. Sobald der Eigentümer genehmigt hat, sind Geschichte, Text, Reihenfolge, Timing und Auswahlen gesperrt. Eine spätere Notiz ändert nur ihr Ziel; listen Sie, was Sie bewahrt haben.

Spezialisten-Checkliste (der Regisseur deckt jeden Punkt kurz ab)

Geschichte (Hook bis 2 s, ein Zustand pro Schlag) · Drehbuch und Stimmlinien (Wörter pro Sekunde ≤ 3,4) · Redaktionelles Tempo (unterschiedliche Aufnahmenlängen, Pausen, nicht jeder Schnitt auf dem Beat) · Art Direction (3 Richtungen als Token-Sets: bg, on-bg, card, on-card, muted, line, paper, on-paper, accent, on-accent, frame, display, ui, mono) · Typografie · Referenzen (borgen / vermeiden / wo verwendet; Grammatik, niemals Inhalt) · Kamera (jede Bewegung hat einen Grund) · Bewegung (Zweck, Easing, Überschwingen ≤ 4 % auf UI, keins auf Typo) · Übergänge (ein einfacher Schnitt ist gültig) · Assets (vorhanden / neu / generiert / Platzhalter, mit Lizenz) · Musik (gemessenes BPM und Phase, Energie-Kurve, wo der Drop landet) · SFX (Asset, Zeit, Auslöser, Verstärkung, Warum) · Mix (Stimme führt, Duck 8 dB, Impact am lautesten) · Engine (gewählt, warum, Alternative, Fallback) · Qualitätssicherung.

Dateien (ein Ordner pro Film)

projects/NNN-name/previs/
  build_previs.py          # schreibt page/previs.json; kopieren Sie examples/crumb-previs/build_previs.py und bearbeiten Sie es (Szenen = HTML Styleframe + Anim-Tweens)
  vo-lines.txt             # 3 Formulierungen pro Zeile, für fish_tts.py
  page/index.html          # erstellt von _shared/previs/app (npm run build; fügen Sie diese Seite als Ziel in scripts/inline.mjs hinzu)
  page/films.json          # [{"id": "NNN-name", "name": "Product", "path": ""}]
  page/previs.json         # der gesamte Plan
  page/audio/{music,vo,sfx}/
  changes.jsonl            # append-only Änderungsprotokoll, ein Vorgang pro Zeile
  approved-video-spec.json # geschrieben von _shared/previs/freeze_spec.py nach Genehmigung

Schritte

  1. Lesen Sie das Briefing oder die Einzeiler-Frage und die Produktquelle (echte UI, Tokens, Text). Schreiben Sie BRIEF.md mit den inferierten Entscheidungen.
  2. Audio (günstig, lokal):
    • Betten: Messen Sie Tempo und Phase durch Comb-Fit über 85–150 BPM auf einer Low-Band-Onset-Hüllkurve (AGENTS-tooling.md, „Previs“); schneiden Sie 24 s Auszüge, die auf einem Beat beginnen, loudnorm auf −18 LUFS: ffmpeg -ss <phase> -t 24 -i bed.wav -af "loudnorm=I=-18:TP=-2,afade=t=out:st=22.5:d=1.5" page/audio/music/A.mp3.
    • Stimme: python3 _shared/tools/fish_tts.py --lines previs/vo-lines.txt --out-dir previs/vo-wav (kostenloses Modell), dann trimmen Sie Stille in page/audio/vo/sN-{A,B,C}.mp3.
    • Foley: Kopieren Sie CC0-Vorschauen von _guide/prompt-studio/media/foley/ oder holen Sie sie mit freesound.py.
  3. Planen Sie in build_previs.py (siehe das Beispiel für jedes Feld): project, summary, chief, story (Beats → Szenen), directors, assets, gates, pipeline, changes, directions (3), global.music|motion|pacing|voice (je 3), engine, references, style_rules, audio_notes, qa, versions, film_css (alle Farben via Tokens, Klassen mit f- präfigiert), fonts_url, und scenes[] mit html, anim (Tweens {s, t:[a,b], f, to, e} auf x, y, s, sx, sy, r, o, clip, w, blur; {s, set, at, until} Klassen-Umschalter; {s, count:[from,to], t, p, d} Zähler; e:'m' folgt dem Bewegungs-Pick), decisions (Übergangstypen cut, push, slide, zoom, iris; Kamera {s,x,y,origin}; vo {text, src, dur, at, copy}), sfx (at kann eine Liste für Läufe sein), key (der Moment des Storyboard-Stills). Geben Sie jedem Element, auf das der Eigentümer zeigen könnte, einen einfachen data-name („Rechnungssumme“, „Anfrage-Button“).
  4. Lokal prüfen: Servieren Sie den Seitenordner, sehen Sie sich einen Still jeder Szene und einen mittleren Übergang an, schalten Sie alle drei Richtungen einmal um, bestätigen Sie keine Konsolenfehler. Ein Durchlauf, keine Schleife.
  5. Teilen Sie die Seite (lokal oder als claude.ai Artifact mit den obigen Fähigkeiten) und fügen Sie den Film Previs Studio hinzu. Geben Sie dem Eigentümer den Link und eine Zusammenfassung von fünf Zeilen. Stoppen Sie für eine Überprüfung.
  6. Überprüfungsschleife (jede Runde ist eine erneute Veröffentlichung):
    • Lesen Sie Notizen, Auswahlen und Genehmigung.
    • Für jede offene Notiz: ändern Sie nur ihr Ziel, fügen Sie einen Vorgang an changes.jsonl an ({"v","target","t","change","from","to","reason","preserve":[...]}), markieren Sie dann die Notiz als erledigt mit einer einzeiligen Antwort (Protokoll oben). Eine revert-Notiz bittet darum, eine aufgeführte Änderung rückgängig zu machen.
    • Erhöhen Sie versions und fügen Sie die Änderungen der Runde in build_previs.py hinzu, führen Sie es erneut aus, kopieren Sie previs.json in die Studio-Kopie, veröffentlichen Sie erneut. Der Player zeigt ein „Was hat sich geändert“-Banner und der Plan listet jede Änderung mit einer Rückgängig-Anfrage auf.
  7. Genehmigung: wenn state/approval approved: true hat (es trägt picks, tweaks und custom), speichern Sie es, führen Sie python3 _shared/previs/freeze_spec.py projects/NNN-name/previs --approval <file> aus (es löst hinzugefügte Optionen und die Stimme auf und listet needs_before_build auf, wie z. B. nicht aufgenommene Zeilen), schreiben Sie SHOTLIST.md aus der Spezifikation, dann übergeben Sie an die in der Spezifikation benannte Engine. Die Engine baut genau die Spezifikation (Nachbesserung erlaubt, Entscheidungen nicht).

Kosten

Nur Einzelarbeit. Eine 20-Sekunden-Previs sind einige Stunden einer Sitzung (etwa $30–60 API-Äquivalent), mit Fish auf dem freien Modell und ohne Renderings. Das Produktions-Rendering und seine Prüfungen kommen nach der Genehmigung.

Individual skills in this repo

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

Verwandte Skills