Communitygithub.com

yazzang-homelab/motion-studio

Ein Format nach dem anderen von einer einzigen Timeline aus versenden: layout()-Umskalierung (nie zuschneiden), alle Formate rendern, format-spezifische Prüfungen, deliver.mjs, ein eigenes Skill, ein Service-Angebot. Verwende für '9:16 und 16:9 exportieren', 'ausliefern', 'ein Skill erstellen'.

Was ist motion-studio?

Motion Studio ist ein AI-Agenten-Skill (für Claude Code, Cursor, Codex etc.), das die gesamte Videoproduktion von einer einzigen Timeline in mehrere Formate (9:16, 1:1, 16:9, 4:5) mit einer reframing-basierten layout()-Methode ermöglicht – ohne Zuschneiden. Es unterstützt die Erstellung markenrelevanter, wiederholbarer Pipelines, die Rendering, Mixing, Audio-Prüfungen (Lautstärke, Spitzenpegel) und Lieferung in einer `deliver.mjs`-Datei bündeln. Der Skill kann in ein benutzerdefiniertes Marken-Skill verpackt werden, sodass der nächste Film nur ein einziger Satz ist (z.B. `/acme-reel launch video for dark mode, 20 s, vertical`). Enthalten sind auch eine optionale Service-Vorlage für den Verkauf von Videoproduktionen sowie integrierte Prüfungen für Stummphasen, Dateigrößenbeschränkungen und das Gate des Kritikprozesses.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Formate, ein Skill und ein Service versenden (Kursschritt 12)

Drei Schritte verwandeln einen guten Clip in ein wiederholbares Geschäft: Jedes Format von einer Timeline exportieren, die Pipeline als Skill verpacken, damit das nächste Video ein Satz ist, und es – falls gewünscht – verkaufen. Arbeite im Projektverzeichnis. Argumente, einmalig gezeigt:

Die Dateien dieses Skills liegen in ${CLAUDE_SKILL_DIR} (Vorlagen in assets/).

1. Pro Format umrahmen, nie zuschneiden

Szenen zeichnen gegen das Layout L (ctx.L in der Factory, c.L in einer draw-Funktion), sodass eine Timeline 9:16, 1:1, 16:9 (und 4:5) rendert – mit für jede Form platzierter Typografie und UI.

FormatGrößeBezeichnung
9x161080x1920Reels, TikTok, Shorts
1x11080x1080X / Feed
16x91920x1080YouTube, Website
4x51080x1350Feed Hochformat
WerkzeugVerwendung
L.uGrößen-Einheit: 1 bei einer 1080 px kurzen Seite; 120 * L.u liest in jedem Format gleich groß
L.Sdas sichere Rechteck {x, y, w, h} aus studio.json safe[fmt] (UI-Ränder der Plattform)
L.pos(ax, ay)ein Punkt innerhalb des sicheren Rechtecks, ax, ay von 0 bis 1
L.pick({ '9x16': a, '1x1': b, '16x9': c, portrait, landscape, square, default })format-spezifische Werte: exakter Schlüssel, dann Ausrichtung, dann Standard
L.split('auto', ratio, gap)zwei Bereiche: gestapelt bei Hochformat und Quadrat, nebeneinander bei Querformat
L.cols(n, gap) / L.rows(n, gap)Spalten oder Zeilen innerhalb des sicheren Rechtecks
fitFontSize(g, text, maxW, (s) => font(s, family, weight), lo, hi, { tracking, step })die größte Größe, die in eine Breite passt (lib/layout.js + lib/draw.js); step: 16 für Bitmap-Schriften
wrapText(g, text, maxW, font(size, family), { maxLines, ellipsis })Zeilen für mehrzeiligen Text, niemals innerhalb einer koreanischen Silbe brechen (lib/draw.js)
draw(g, lt, c) {
  const { L, brand } = c;
  const { a, b } = L.split('auto', L.pick({ landscape: 0.45, default: 0.4 }), 32 * L.u);   // Titel | Produkt
  const size = Math.min(L.pick({ '9x16': 170, '1x1': 140, '16x9': 150 }) * L.u,
                        fitFontSize(g, 'MACH ES BEWEGEND.', a.w, (s) => font(s, brand.fonts.display, 400)));
  kinetic(g, 'MACH ES BEWEGEND.', a.x, a.y + a.h * 0.6, lt, { size, family: brand.fonts.display, weight: 400, color: brand.colors.fg, spring: 'default' });
  drawProduct(g, b, lt, c);                                         // das Produkt-UI füllt Bereich b in jedem Format
}

Regeln: keine direkten Pixel; Schlüsselinhalte innerhalb von L.S; derselbe Moment geschieht zeitgleich in jedem Format (nur Platzierung und Größe ändern sich); ein Format, das wie ein Ausschnitt eines anderen aussieht, ist ein P1 in der Kritik. Passe die safe-Ränder in studio.json an, nicht im Code. Vorschau jedes Formats mit npm run preview (F schaltet Formate um, G zeigt die sicheren Hilfslinien).

2. Jedes Format prüfen

Der Kritik-Durchlauf erfolgt im primären Format; vor dem Finale mindestens eine Runde pro anderem Format, jeweils mit eigenem Nachweis (ca. 115 s Tool-Zeit pro Live-Durchlauf und 85 s pro --video-Durchlauf, gemessen an einem 12 bis 20 s Film):

node tools/stills.mjs --format 1x1
node tools/render.mjs --format 16x9 --draft --sub 1 --scale 0.5     # ca. 20 s; dann: npm run sfx, node tools/mix.mjs --format 16x9
node tools/critique.mjs --format 16x9                                 # Live-Film -> out/review/16x9/
node tools/critique.mjs --format 16x9 --video out/16x9/final.mp4      # gemischter Render -> out/review/16x9/video/

Protokolliere jede als eigene Runde (## Runde <n> — 16x9 — ...). Das Gate liest die letzte Runde, beende daher mit einer bestandenen Runde.

3. Rendern, mischen, liefern

Diese Schritte dauern Minuten: Der 12-s-Demo-Render dauert etwa 4 min für drei Formate bei 60 fps (ca. 20 s pro Sekunde Film), mix dauert 40 bis 80 s und deliver etwa 40 s. Starte npm run build, render:final, mix und deliver mit der run_in_background-Option des Bash-Tools und einem Log, frage das Log ab (tail -n 3), lies das Ergebnis nach der exit-Zeile und warte nie länger als etwa 2 Minuten im Vordergrund; füge --chunk 10 bei einem Finale mit drei oder mehr Formaten oder bei mehr als ca. 30 s hinzu. Das Motion-Reel-Runbook („Lange Befehle“) enthält das Muster.

SchrittBefehlAusgabe
alles, in Reihenfolgenpm run buildScore (falls fehlend), SFX, finaler Render aller Formate, Mix, Deliver
finaler Render (gegated)npm run render:finalout/<fmt>/silent.mp4, poster.png, render.json für jedes Format in studio.json formats
Mix und Muxnpm run mixout/score.wav, out/<fmt>/final.mp4, out/final.mp4 (primär), out/poster.png
Prüfungen und Paketnpm run deliverout/deliver/<slug>_<fmt>.mp4 + Poster + jede Seite des Kontaktbogens (<slug>_<fmt>_contact.png, dann _contact-2.png …), out/deliver/manifest.json, docs/production.json

deliver.mjs prüft pro Format out/<fmt>/final.mp4 gegen die AKTUELLE studio.json: Framecount (Dauer × fps), die Formatgröße, fps und exakte Dauer (ein vor einer Bearbeitung von duration oder fps gerenderter Schnitt schlägt fehl als stale render; ein Entwurfs- oder skalierter Render schlägt ebenfalls fehl), integrierte Lautstärke und True Peak gegen audio.lufs ± audio.lufsTolerance und audio.truePeak; Stummphasen (eine Phase von 1 s oder mehr unter -50 dB schlägt fehl als silence, z. B. silence 2.2 s at 00:02.1, es sei denn, sie beginnt in den ersten 0,3 s, beginnt in der letzten Sekunde oder liegt innerhalb eines critique.allowSilence-Intervalls); Dateigröße gegen deliver.maxBytes (Standard x: 536.870.912 Bytes = X‘s 512 MB Upload-Limit; füge die Limits anderer Plattformen dort hinzu); Poster vorhanden; die Loop-Naht bei Loop-Filmen; und das Kritik-Gate. Es warnt (kein Fehler), wenn Filmquellen neuer sind als der Render. Es beendet mit 1 und benennt jede fehlgeschlagene Prüfung; ein nicht lesbares final.mp4 schlägt ebenfalls fehl. Mit --json gibt ein Fehler eine Zeile { ok: false, error, failed: [...] } aus, auch wenn der Lauf nicht starten kann (eine ungültige studio.json, ein unbekanntes Format, ein falsches Flag). --format 1x1 liefert nur dieses Format erneut aus und behält die gelieferten Dateien und Manifest-Einträge der anderen (carriedOver); ein fehlschlagendes Gate widerruft jede gelieferte Datei. docs/production.json zeichnet Titel, Formate, Dauern, Lautstärke, Runden, letzte Scores, den Aufwand (aus CLAUDE_EFFORT falls gesetzt) und Tool-Versionen auf.

Fehlgeschlagene PrüfungBehebung
Frames oder Dauer abweichend, oder stale rendernpm run render:final erneut ausführen; niemals einen teilweisen Render ausliefern
Lautstärke oder True Peak/motion-studio:sound-design (Mix-Berichtstabelle)
silenceEin Stem endet früh oder ein Bett läuft unter nichts: neu generieren (npm run score, sfx, voice), npm run mix, erneut ausliefern
Größe über Limitnode tools/render.mjs --format <f> --final --crf 18 dann npm run mix erneut
Poster fehltstudio.json poster (Sekunden) setzen oder --no-poster weglassen
Gate/motion-studio:critique-loop

Melde dem Benutzer: jede Datei in out/deliver/, die format-spezifischen Zahlen aus dem Manifest, die Scores der letzten Runde und was du als nächstes verbessern würdest.

4. Die Pipeline als eigenes Skill des Benutzers verpacken

Damit das nächste Video ein Satz ist (/acme-reel launch video for dark mode, 20 s, vertical):

  1. Wähle den Namen: <brand>-reel, Kleinbuchstaben, Ziffern und Bindestriche.
  2. Erstelle .claude/skills/<brand>-reel/SKILL.md im Repository der Marke (Projektumfang, über Git geteilt) oder in ~/.claude/skills/<brand>-reel/SKILL.md (persönlich). Beginne mit ${CLAUDE_SKILL_DIR}/assets/brand-skill-template.md (assets/brand-skill-template.md).
  3. Befülle es aus diesem Projekt, nicht aus dem Gedächtnis: studio.json Markenwerte, docs/style_guide.md, die genehmigte docs/shotlist.md als Story-Beat-Muster und die Lektionen in docs/review_log.md (was der Kritiker stets beanstandete, wird zur harten Regel). Kopiere das Logo nach .claude/skills/<brand>-reel/assets/.
  4. Halte die Beschreibung unter etwa 230 Zeichen mit konkreten Auslösephrasen, den Text unter etwa 200 Zeilen.
  5. Teste es in einer frischen Sitzung mit einer echten Anfrage und überprüfe, dass es nur nach dem fragt, was sich pro Video ändert.
  6. Um es über ein Repository hinaus zu teilen, veröffentliche es als Plugin (ein Repository mit .claude-plugin/plugin.json und skills/<name>/SKILL.md), so wie buildwithhanif/claude-animation-skill und dieses Plugin veröffentlicht sind.

5. In einen Service verwandeln (optional)

${CLAUDE_SKILL_DIR}/assets/service-offer.md (assets/service-offer.md) ist eine ausfüllbare Angebotsvorlage: Was enthalten ist (Musik, ein Maskottchen in jedem Stil, Produktfunktionen, ein Angebot am Ende, jede Sprache, bis zu 3 Bearbeitungen), Formate, Durchlaufzeit, was der Kunde bereitstellt, Rechte und Offenlegung sowie Preisgestaltung. Preisanker: Tony Dinh berichtete, etwa 1.000 $+ für ein ähnliches Launch-Video bezahlt zu haben, ein Jahr bevor er eines mit Opus 5.5 in unter 30 Minuten erstellte (https://x.com/tdinh_me/status/2103703135902740699). Hilf dem Benutzer, es auszufüllen; veröffentliche oder sende es nicht für ihn.

Als Nächstes: Beginne den nächsten Film mit /motion-studio:motion-reel oder dem neuen /<brand>-reel-Skill des Benutzers.

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

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

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

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