Communitygithub.com

yazzang-homelab/motion-studio

Langformatige oder nächtliche Filme planen: Regieanweisung (PLAN FIRST oder GO, Budget, Definition von „Fertig“), ANIMATION_GUIDE + STORYBOARD, Kapitel-Subagenten, Gates, chunked Render. Für ‚Übernachtfilm‘, ‚Musikvideo‘, ‚2-Minuten-Film‘.

Was ist motion-studio?

Dieses Skill verwandelt die Idee eines Nutzers in eine vollständige Filmproduktion – von der ersten Logline bis zum endgültigen Rendern. Es ist für längere Filme (über 45 Sekunden) konzipiert und führt den gesamten Prozess durch mehrere Qualitäts-Gates: Planung, Style-Analyse, Storyboarding, detaillierte Animation Guides und paralleles Rendern von Kapiteln durch Subagenten. Das Skill unterstützt verschiedene Routen, darunter eine reine Code-Route und eine „Generate-then-Trace“-Route, bei der KI-generierte Videos als Basis für präzise Code-Animationen dienen. Es ist besonders nützlich für Übernachtfilme, Musikvideos und kurze Erklärfilme, bei denen eine hohe planerische Qualität und widerspruchsfreie visuelle Umsetzung wichtig sind. Die Nutzer sollten ein klares Budget und eine Route definieren, da das Skill mit maximaler KI-Denkfähigkeit läuft und entsprechende Kosten verursacht.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/director-brief

In Ihrer bevorzugten KI fragen

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

Dokumentation

Regieanweisung (Kursschritt 10)

Lange Filme sind Produktionen. Die Briefings hinter den Übernachtfilmen im Kurs beschreiben kein Video; sie beauftragen ein Team: eine Logline, an der jede Entscheidung gemessen wird, Referenzen, Werkzeuge und Budget, eine Charakter-Bibel, ein Beat-Blatt, Text-auf-Bildschirm-Regeln, Gates, eine Kritik-Schleife und Liefergegenstände. Dieses Skill verwandelt die Idee des Benutzers in dieses Briefing und führt die Produktion durch die Gates. Für Clips bis zu etwa 45 Sekunden ohne Kapitel verwenden Sie stattdessen /motion-studio:motion-reel (denselben Schwellenwert, den dieses Skill verwendet, um einen längeren Film an dieses Skill zu übergeben).

Argumente, einmal angezeigt:

Die Dateien dieses Skills befinden sich in ${CLAUDE_SKILL_DIR} (die Briefing-Vorlage ist ${CLAUDE_SKILL_DIR}/assets/brief-template.md, assets/brief-template.md).

Kosten dieses Skills

Es läuft mit der Anstrengung max: der tiefsten Überlegung und der höchsten Token-Nutzung aller motion-studio-Skills. Planungsfehler summieren sich über Stunden autonomer Arbeit, daher werden die Ausgaben hier sinnvoll investiert. Setzen Sie Erwartungen mit dem Benutzer, bevor Sie beginnen. Gemeldete Datenpunkte aus dem Kurs: Ein Übernacht-Musikvideo dauerte etwa 12 Stunden und verbrauchte etwa 80 % des Nutzungskontingents eines Max-Plans plus 75 $ für Bild-/Video-API-Guthaben; ein 45-Sekunden-Handanimations-Kurzfilm benötigte 163 Modellaufrufe, 62,7 M Token (96 % Cache-Lesevorgänge), etwa 34 $ zu API-Listenpreisen und etwa 6,75 Stunden. Halten Sie den Rest günstiger: Kapitel-Animatoren laufen mit ihrer eigenen Anstrengung (hoch), und Reparaturen und Neurenderungen sind mittelschwere Arbeit. Sagen Sie dem Benutzer, er solle die Sitzungsanstrengung mit /model senken, sobald der Plan genehmigt ist, wenn das Budget eine Rolle spielt.

1. Eingaben sammeln

Nur die Hauptsitzung kann dem Benutzer Fragen stellen (Subagenten können das nicht). Wenn der Benutzer ein langes Briefing diktiert hat, parsen Sie es, anstatt erneut zu fragen. Fragen Sie andernfalls einmal, in einer Nachricht, nach dem, was fehlt:

EingabeWarum
Logline, und was der Zuschauer am Ende fühlen sollJede Entscheidung wird daran gemessen
Dauer, Formate, wo es veröffentlicht wirdKapitelanzahl, Renderzeit, Sicherheitsbereiche
Referenzen (Video, Einzelbilder, Bildbibliothek, vorheriges Repository)Grammatik übernehmen, zu vermeidende Inhalte
Musik: ein Track (und seine Lizenz) oder „synthetisieren“Das Beat-Raster, an dem sich alles orientiert
Route (A Standard; B nur, wenn sie Remotion/HyperFrames nennen; C generate-then-trace) und API-Schlüssel nach VariablennamenWerkzeuge und Ausgaben
Budget: Modellnutzung, kostenpflichtige APIs, WanduhrzeitWann das Generieren beendet werden soll
Modus: PLAN FIRST oder GOOb nach dem Plan angehalten werden soll

2. docs/brief.md schreiben

  1. Wenn es keine studio.json gibt, führen Sie zuerst /motion-studio:studio-init aus (setzen Sie --duration, --bpm, --formats).
  2. Kopieren Sie ${CLAUDE_SKILL_DIR}/assets/brief-template.md nach docs/brief.md. Füllen Sie Teil A mit den Antworten des Benutzers; lassen Sie Teil B wie er ist.
  3. Aktualisieren Sie studio.json, um dies abzugleichen (Titel, Dauer, fps, bpm, Formate, Marke, loop).
  4. PLAN FIRST: Zeigen Sie das ausgefüllte Briefing und stoppen Sie, bis der Benutzer zustimmt. GO: Zeichnen Sie jede Entscheidung, die Sie für den Benutzer getroffen haben, in docs/decisions.md auf und fahren Sie fort.

3. Gate 1: Planungsdokumente

DateiInhaltWer schreibt sie
docs/style_guide.mdPalette, Typografie, Tempo, Übergänge, Textur, verbotene Looksstyle-analyst Subagent aus Referenzen (/motion-studio:reference-style), oder Sie
docs/STORYBOARD.mdDie Idee, Besetzung, was alles zusammenhält, Kapitel mit zeitlich festgelegten Einstellungen und Übergängenmotion-director Subagent, oder Sie
docs/shotlist.mdJede Einstellung auf dem Beat-Raster (Takten), Kamera, Text, Soundeffektemotion-director
Kapitelplan (in STORYBOARD)Kapitelgrenzen auf Downbeats, Besitzer pro KapitelSie

Messen oder synthetisieren Sie die Musik, bevor Sie etwas timen (/motion-studio:sound-design): Kapitel- und Einstellungszeiten sind grid.bar(n)-Werte, keine Schätzungen. Halten Sie Kapitel zwischen 8 und 30 Sekunden, damit ein Subagent eines in einer Sitzung fertigstellen und überprüfen kann. Der motion-director schreibt nur docs/** (der Rollen-Guard-Hook erzwingt dies).

4. Gate 2: Rig und Anleitung

  1. Schreiben Sie docs/ANIMATION_GUIDE.md aus der Vorlage im docs/-Verzeichnis des Projekts, bevor ein Kapitel-Animator beginnt, damit jedes Kapitel im gleichen Stil codiert: wie ein Kapitel funktioniert, Eigentum, Layout und reservierte Bänder, die gemeinsame API, gemeinsame Elemente, Stilregeln mit einem Paint-Time-Budget und genaue Prüfbefehle.
  2. Bauen Sie gemeinsame Elemente (Held-Figur, UI-Kit, Paletten-Helfer) selbst in film/scenes/shared_<name>.js. Kapitel-Animatoren importieren sie und bearbeiten sie nie. Rendern Sie Standbilder jedes Elements in jedem Zustand.
  3. Stubben Sie jedes Kapitel, damit der Film durchgängig rendert, während die Kapitel bearbeitet werden:
// film/scenes/ch03_build.js (Stub geschrieben von der Hauptsitzung; der Kapitel-Animator ersetzt die Einstellungen)
import { chapter } from '../../lib/timeline.js';
export const BARS = [12, 20];                          // Spanne in Takten aus docs/STORYBOARD.md (null = bis zum Ende)
export default function ch03(ctx) {
  const FROM = BARS[0] === 0 ? 0 : ctx.grid.bar(BARS[0]);
  const TO = BARS[1] == null ? ctx.dur : ctx.grid.bar(BARS[1]);
  return chapter({ name: 'ch03_build', from: FROM, to: TO, shots: [], cues: [] });   // keine Einstellungen = Platzhalterkarte
}
  1. Verdrahten Sie film/film.js einmal. buildFilm akzeptiert chapter()-Ergebnisse innerhalb von scenes, glättet deren Szenen und führt deren Cues zusammen. Filmweite Ebenen (Untertitel, Naht-Übergänge) gehen in die overlays: Scene[] des Factories: sie malen nach jeder Szene, in Array-Reihenfolge, auf der gleichen from <= t < to-Regel (am letzten Frame des Films endinklusive), und sie zählen nie als Einstellungen, daher listen Standbild-Labels, Kritik-Einstellungsgrenzen und die Vorschau-Leiste nur Kapitel-Einstellungen. Der Kapitel-Code bleibt unberührt; wickeln oder patchen Sie keine Kapitel-draw-Funktionen. Verschachtelte Arrays, null und chapter()-Ergebnisse werden auch in overlays akzeptiert, sodass ein Kapitel seine eigenen Overlay-Szenen liefern kann. Um gewöhnliche Szenen zu stapeln, geben Sie einer Szene eine layer-Nummer (Standard 0): Szenen malen nach (layer, from).
import { defineFilm, scene } from '../lib/timeline.js';
import ch01 from './scenes/ch01_hook.js';
import ch02 from './scenes/ch02_problem.js';
import ch03 from './scenes/ch03_build.js';

const CHAPTERS = [ch01, ch02, ch03];

export default defineFilm((ctx) => ({
  scenes: CHAPTERS.map((make) => make(ctx)),
  overlays: [
    scene(0, ctx.dur, 'captions', (g, lt, c) => { /* filmweite Untertitel: zeichnen von Filmzeit c.t */ }),
    // eine kurze Szene pro Kapitelnaht, die einen Übergang benötigt, getimed vom Raster
    scene(ctx.grid.bar(12) - 0.2, ctx.grid.bar(12) + 0.2, 'seam-ch02-ch03', (g, lt, c) => { /* Wischen oder Blitzen */ }),
  ],
  cues: (grid) => [{ t: grid.bar(0), type: 'hit' }],   // Filmebenen-Cues; Kapitel-Cues werden automatisch zusammengeführt
}));

5. Kapitel ausrollen

Starten Sie einen chapter-animator-Subagenten (motion-studio:chapter-animator) pro Kapitel, mehrere parallel. Briefen Sie jeden ein mit: seiner Datei (film/scenes/chNN_<name>.js), seiner Spanne (dem BARS-Export in seinem Stub, plus derselben Spanne in Sekunden für die Prüfbefehle), seinem STORYBOARD-Abschnitt und „befolgen Sie docs/ANIMATION_GUIDE.md“. Der Rollen-Guard-Hook erlaubt einem Kapitel-Animator nur, film/scenes/** zu schreiben (außer film/scenes/shared_*, die für Kapitel-Animatoren schreibgeschützt bleiben, die stattdessen Fehler in gemeinsamen Dateien melden) und out/check/**. Jeder gibt einen Bericht zurück: was er gebaut hat, Überprüfungsstandbilder, bekannte Probleme und Fehler, die er in gemeinsamen Dateien gefunden hat. Sie reparieren gemeinsame Dateien, führen die filmweiten Prüfungen erneut aus und briefen ein Kapitel neu, wenn sein Bericht ein Problem zeigt.

Kapitelspannen sind Takte, berechnet mit ctx.grid innerhalb des Kapitel-Factories, sodass aufeinanderfolgende Kapitel sich immer treffen und einer gemessenen Spur folgen. Einstellungszeiten sind absolute Filmsekunden, die vom Raster genommen werden (shots: [{ at: grid.bar(13), name: 'assemble', draw }, ...]); jede Einstellung läuft bis zum nächsten at, und ihre draw(g, lt, c) erhält lt ab dem Start der Einstellung. Eine Einstellung außerhalb der Kapitelspanne lässt chapter() einen Fehler werfen und der Film stoppt das Laden (z. B. lehnt ein wörtliches TO = 4 eine Einstellung bei grid.bar(1) = 4,003 s ab, sobald eine gemessene Spur den ersten Downbeat bei 2,0 s platziert).

6. Gates 3 bis 8

GateMachenPrüfen
3 Standbildernode tools/stills.mjs --shots (ein Standbild pro Einstellung)Kritikrunde (/motion-studio:critique-loop)
4 Animaticnpm run animatic (halbe Skalierung, 30 fps, kein Weichzeichner) mit dem echten oder Platzhalter-TrackTempo: jede Lesung landet vor dem nächsten Beat
5 schwierigstes Samplenode tools/render.mjs --from A --to B --out out/check auf den schwierigsten 2 bis 4 snode tools/critique.mjs --strip-at <t>; Determinismus; Synchronisation
6 vollständiger Durchlaufkein Platzhalter mehr vorhanden (kein Einstellungslabel in node tools/stills.mjs --shots endet auf /placeholder)Kritikrunde auf dem gesamten Film
7 Polieren und Sound/motion-studio:sound-design: Partitur oder Beats, Cues, Soundeffekte, StimmeSynchronisationsmetrik, Tonachse
8 Finalenpm run buildDie Definition von „Fertig“ in Briefing B6

Lange Filme rendern in fortsetzbaren Segmenten: node tools/render.mjs --format all --final --chunk 10 schreibt out/<fmt>/.parts/seg_<a>_<b>.mp4 und überspringt fertige Segmente, wenn es nach einer Unterbrechung erneut ausgeführt wird. Führen Sie lange Renderings im Hintergrund aus (das Bash-Tool run_in_background oder eine Logdatei, die Sie abfragen), anstatt die Sitzung zu blockieren, und warten Sie im Vordergrund nie länger als etwa 2 Minuten. Kalkulieren Sie etwa 20 s Wandzeit pro Sekunde Film für drei Formate bei 60 fps und 4 Subframes (ein 2-Minuten-Film entspricht etwa 40 Minuten Rendering); das Pipeline-Runbook von /motion-studio:motion-reel enthält das Muster und die erwartete Zeit für jeden anderen Befehl. Ein Kapitel-Animator oder ein anderer Subagent darf nicht zurückkehren, während ein von ihm gestarteter Befehl noch läuft.

7. Route C: generate-then-trace (optional)

Nur wenn das Briefing Route C auswählt und die Schlüssel auflistet (nach Variablennamen: FAL_KEY, ELEVENLABS_API_KEY in .env) und ein Budget. Videomodelle liefern Physik, Timing und Gesichter, die schwer zu handcodieren sind; die Code-Ebene liefert ein konsistentes Aussehen, das dem Benutzer gehört. Zuschauer sehen die Code-Ebene.

  1. Generieren Sie Charakterblätter und Basis-Einstellungen mit dem vom Benutzer gewählten Dienst, gemäß dessen eigener Dokumentation. Speichern Sie jedes Ergebnis unter refs/base/ mit einem Manifest-Eintrag (Dienst, Modell, Prompt, Seed, Kosten, Lizenz). Stoppen Sie beim Budget.
  2. Extrahieren Sie Einzelbilder zum Studieren: node tools/refs.mjs extract refs/base/shot01.mp4 --every 0.1 --out refs/base/shot01.
  3. Zeichnen Sie jede Einstellung in Code auf diesem Timing neu (schauen Sie sich die Einzelbilder an, bauen Sie die Bewegung mit Federn und Spuren wieder auf). Basis-Filmmaterial wird zur Renderzeit nie aus dem Netzwerk geladen; wenn eine Einstellung ein Basis-Bild compositet, laden Sie es aus einer lokalen Datei in setup().
  4. Überprüfen Sie die Synchronisation: Standbilder der Code-Ebene neben Basis-Einzelbildern zu denselben Zeiten und die Audio-Cues auf dem Raster. Wiederholen Sie den Schritt für jede Einstellung, die driftet.

Schlüssel: niemals drucken, ausgeben, protokollieren oder einfügen. Werkzeuge lesen .env selbst; nennen Sie die Variable in Eingabeaufforderungen und Dokumenten.

8. Definition von Fertig und Bericht

Das Briefing B6 ist der Vertrag: Lautstärke -14 LUFS +-0,5 und <= -1 dBTP auf der gelieferten MP4, mindestens 3 Kritikrunden mit jeder Achse >= 8 und kein P0 (npm run gate), ein Neurender ergibt identische Einzelbilder (Kritik-Determinismus-Prüfung plus gleiche framesDigest-Werte von zwei --hash-Renderings), exakte Dauer und Einzelbilder in jedem Format, und alle Liefergegenstände vorhanden (npm run deliver prüft das meiste und schreibt docs/production.json). Beenden Sie mit dem B7-Bericht: Liefergegenstände, Bewertungen pro Runde, tatsächliche Ausgaben, bekannte Mängel, was Sie beim nächsten Mal verbessern würden.

Credits: Das Briefing-Skelett folgt Schritt 10 des Kurses; die Aufteilung Ausfüllen/Unverändert-Lassen, PLAN FIRST vs GO und eine Definition von Fertig folgen einem öffentlichen Vorlagenmuster von @pradeepXkapoor (umformuliert); die Abnahmegates sind angepasst von athemeroy/awesome-opus-5-5-videos docs/production-brief.md (CC BY 4.0); das Guide-plus-Storyboard-Subagenten-Muster wurde in JohnHeibel/PDoomVideo studiert (nur Ideen, kein Text wiederverwendet).

Weiter: /motion-studio:critique-loop nach jedem Gate ab 3, dann /motion-studio:ship-formats zur Auslieferung.

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

Verwandte Skills