Communitygithub.com

yazzang-homelab/motion-studio

Erstellt ein Motion-Studio-Filmprojekt (seek(t)-Renderer, Federn, Beat-Raster, synthetisierter Sound, Kritik-Tools), installiert es, richtet den Browser ein und führt den Arztlauf aus. Verwende für 'Richte das Motion Studio ein', 'Neues Filmprojekt', 'Studio initialisieren'.

Was ist motion-studio?

Diese Fähigkeit (Skill) richtet ein vollständiges Filmprojekt für das Motion Studio ein – einen leistungsstarken, agentenbasierten Rendering-Workflow, der auf dem seek(t)-Renderer, Federsimulationen, Beat-Rastern und synthetisiertem Sound basiert. Sie ist für KI-Agenten wie Claude Code, Cursor oder Codex konzipiert und ermöglicht es, einen Film von der Vorlage zu erstellen, zu rendern, zu kritisieren und zu liefern, ohne dass eine manuelle Konfiguration erforderlich ist. Der Skill führt den Benutzer durch die Projektinitialisierung, Installation von Abhängigkeiten (einschließlich Playwright für die Browser-basierte Vorschau), Browser-Setup mit automatischer Headless-Shell für Windows und Diagnose mit `npm run doctor`. Er optimiert die Schleife des Films – den entscheidenden Unterschied zwischen einem mittelmäßigen ersten Versuch und einem veröffentlichungswürdigen Werk. Unterstützt werden verschiedene Ausgabeformate (9x16, 1x1, 16x9, 4x5), benutzerdefinierte Zeitsteuerung (BPM, FPS), nahtlose Schleifen und Branding-URLs. Nach der Einrichtung kann der Agent Befehle wie `npm run stills`, `npm run preview` oder `npm run critique` ausführen, um das Projekt zu testen und zu iterieren. Zusätzliche Begleitskills wie claude-animation, HyperFrames und Remotion können bei Bedarf integriert werden.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Studio-Initialisierung (Kursschritt 02)

Erstelle ein Filmprojekt, das seine eigenen Bilder rendern, anhören und betrachten kann. Die Chat-App kann eine Animation schreiben; nur ein Agent mit einer Shell kann den Render schließen, schauen und die Schleife korrigieren. Diese Schleife ist der Unterschied zwischen einem „mittelmäßigen“ ersten Versuch und einem Film, der es wert ist, veröffentlicht zu werden.

Anforderungsargumente (können leer sein), einmal angezeigt:

1. Wähle das Verzeichnis und die Einstellungen

  • Verzeichnis: das erste Argument; sonst ., wenn das Arbeitsverzeichnis leer ist; sonst frage (Standard ./<slug-des-titels>). Niemals in das Plugin-Verzeichnis gerüsten.
  • Einstellungen aus der Anforderung: Titel, Dauer, Formate, FPS, BPM, Schleife, Marken-URL. Den Rest auf die Vorlagenstandards setzen (studio.json: 12 s, 60 fps, 4 Unterbilder, 120 BPM, 9x16 primär).

2. Gerüst

npm install -g "${CLAUDE_SKILL_DIR}/scripts/init.mjs" <verz> --title "<Titel>" [--duration S] [--fps N] [--bpm N] [--formats a,b] [--loop] [--brand-url URL] [--install] [--json]
FlagWirkung
<verz>Ziel; wird erstellt, falls nicht vorhanden
--title Tstudio.json Titel und Slug der Lieferdatei
--duration S, --fps N, --bpm NZeitsteuerung
--formats a,bTeilmenge von 9x16, 1x1, 16x9, 4x5 (oder all); primaryFormat bleibt, es sei denn, es ist nicht aufgeführt
--loopNahtlose Schleife (UI-Morphs)
--brand-url URLSpeichert die Produkt-URL in brand.url. user:password@ und geheimnisaussehende Parameter (query, ;matrix, fragment: token, key, secret, password, auth, sig, session, code ...) werden entfernt, bevor etwas geschrieben wird; stderr nennt, was entfernt wurde und --json listet es in redacted. Gib trotzdem eine einfache öffentliche URL an: ein Geheimnis, das ein bloßer Pfadabschnitt ist (/reset/<token>), kann nicht erkannt werden. Eine einfache URL wird genau so gespeichert, wie sie eingegeben wurde
--installführt npm install im neuen Projekt aus (handhabt npm.cmd unter Windows)
--forceaktualisiert ein älteres Projekt auf die aktuelle Vorlage (siehe Tabelle unten)
--jsoneine JSON-Ergebniszeile auf stdout

Ein vorhandenes nicht leeres Verzeichnis wird zusammengeführt: nur fehlende Dateien werden hinzugefügt und übersprungene Dateien werden aufgelistet. Melde die übersprungene Liste dem Benutzer; lösche niemals seine Dateien.

--force bei einem vorhandenen Projekt (geprüft gegen init.mjs):

PfadMit --force
studio.json, film/**, docs/**, assets/fonts/fonts.jsonbehalten und als kept aufgelistet; eine fehlende wird trotzdem erstellt. Flags wie --bpm patchen weiterhin studio.json
package.jsonzusammengeführt, nie ersetzt: setzt type: module, fügt private, engines und jedes Vorlagenskript oder jede Abhängigkeit hinzu, die dem Projekt fehlt. Ein Vorlagenskript, dessen Befehl abweicht, wird auf den Vorlagenbefehl zurückgesetzt (init gibt jedes als was ..., now ... aus und gibt sie in packageReset zurück). Abhängigkeitsversionen werden nie geändert, auch nicht Vorlagenabhängigkeiten: ein vorhandener Bereich bleibt bestehen, neuere, ältere oder festgeschriebene. Name, Version, andere Skripte und andere Felder bleiben erhalten
.gitignorezusammengeführt: fehlende Vorlagenzeilen werden unter # motion-studio angehängt, nichts wird entfernt
alles andere (CLAUDE.md, lib/**, tools/**, prompts/**, index.html, .env.example, gebündelte Schriftarten)überschrieben und als overwritten aufgelistet. Lokale Bearbeitungen dieser Dateien gehen verloren: committe oder kopiere sie zuerst
deine eigenen zusätzlichen Dateienunberührt

Ohne --force werden package.json und .gitignore auf die gleiche Weise zusammengeführt, außer dass ein abweichendes Skript deinen Befehl behält. Init listet jedes Skript und jede Abhängigkeitsversion, die von der Vorlage abweicht, unter kept your package.json values, which differ from the template auf (packageKept im --json-Ergebnis): diese npm run-Namen führen DEINEN Befehl aus, und --force setzt Vorlagenskripte zurück (niemals Abhängigkeitsversionen). Ein scripts-, devDependencies- oder optionalDependencies-Abschnitt, der kein Objekt ist, wird mit einer Warnung unverändert gelassen. Da docs/** behalten wird, erreicht eine neuere Vorlagendokumentation nie ein vorhandenes Projekt: vergleiche nach einem Update manuell mit dem template/docs/ des Plugins.

3. Installation, Browser, Arztlauf

  1. Ohne --install, führe npm install im Projekt aus. playwright ist die einzige erforderliche Abhängigkeit; ffmpeg-static ist optional und kann hinter einem Proxy beim Herunterladen fehlschlagen.
  2. Browser (npm run setup:browser ist derselbe Befehl wie die npx-Zeile):
    • Windows: führe npx playwright install chromium-headless-shell aus (ca. 115 MB Download, 270 MB auf der Festplatte). studio.json browser: "auto" startet nur diese gebündelte Headless-Shell, niemals das installierte Chrome oder Edge. Grund: Ein installiertes Chrome oder Edge, das mit einem neuen Profil (bei jedem Tool-Lauf) gestartet wird, veranlasst Chrome, das Windows-Konto auf ein leeres Passwort zu testen, was als fehlgeschlagene Anmeldung zählt. Der gemessene Laptop sperrt das Konto nach 10 fehlgeschlagenen Anmeldungen in 10 Minuten und protokollierte 464 in 24 h. Wechsle browser nicht auf chrome oder msedge und setze MOTION_CHROME_PATH nicht auf eine chrome.exe oder msedge.exe, es sei denn, der Benutzer fragt danach und akzeptiert das Risiko: es gibt eine Warnung pro Start aus und der 4. Start in 10 Minuten wird verweigert, 3 passieren (der Startschutz). Die Shell ist nicht signiert, daher kann eine Echtzeit-Antivirensoftware jeden Tool-Lauf um 15 bis 25 s verlangsamen (gemessen): teile dem Benutzer dies einmal mit; ein Antivirenausschluss für %LOCALAPPDATA%\ms-playwright ist seine oder die Entscheidung der IT.
    • macOS und Linux: auto versucht das installierte Chrome, dann Edge, dann den gebündelten Browser, ohne Warnung. Wenn keines installiert ist, führe npx playwright install chromium-headless-shell aus (Linux: npx playwright install --with-deps chromium-headless-shell), oder setze MOTION_CHROME_PATH auf eine ausführbare Datei der Chromium-Familie.
  3. npm run doctor. Behebe jede FEHLER-Zeile vor der Übergabe und unter Windows auch eine WARN-Browser-Zeile (ein installiertes Chrome oder Edge wurde ausgewählt: lösche es und installiere die Headless-Shell); Korrekturen pro Betriebssystem findest du in references/troubleshooting.md. Python mit librosa ist optional (die JS-Beat-Engine deckt es ab). Node 22+ wird nur für Route-B-Tools benötigt.
  4. Beweise es: npm run stills, öffne dann out/review/9x16/contact.png (ein langer Film wird seitenweise ausgegeben: contact.png ist Seite 1, dann contact-2.png ..., keine Seite höher als 1800 px; öffne jede Seite) und schaue es dir an. Die mitgelieferte 12-s-Demo muss ein zusammengesetztes Bild bei 0 s und eine Änderung bei jedem Downbeat zeigen. npm run preview öffnet die Live-Vorschau (Leertaste Abspielen/Pause, Pfeile Einzelbildschritte, F wechselt Formate, G Safe-Area-Richtlinien).

4. Erkläre das Projekt dem Benutzer

Fasse es in ein paar Zeilen zusammen und verweise dann auf die Referenzen:

  • Layout und wer was bearbeitet: references/project-layout.md
  • Jeder Befehl: references/commands.md
  • Jede lib/-Signatur und Standardeinstellung: docs/API.md im neuen Projekt (die vollständige Referenz ist docs/ARCHITECTURE.md im Plugin-Repository)
  • Die Hausregeln stehen in der CLAUDE.md des Projekts, die Claude Code bei jedem Lauf dort liest.

Wenn init eine ★ Sternzeile gedruckt hat (starHint im --json-Ergebnis; sie erscheint einmal pro Maschine, beim ersten neuen Projekt), beende deine Zusammenfassung mit dieser einen Zeile, wie sie geschrieben wurde. Gib niemals das Repository oder führe gh für den Benutzer aus.

BefehlTut
npm run previewLive-Vorschau im Browser
npm run stillsein Standbild pro Beat als Kontaktbogen
npm run critiqueKontakt, Streifen, Telefontest, Metriken, Review-Log-Block
npm run gateKritik-Gate: 3 Runden, alle Achsen >= 8, kein P0
npm run render:finaljedes Format, endgültige Qualität (Gate erzwungen)
npm run sfx / npm run mixCue-SFX synthetisieren / auf -14 LUFS mischen und muxen
npm run deliverLieferprüfungen und out/deliver/-Paket
npm run buildPartitur, falls fehlend, SFX, finaler Render, Mix, Lieferung

5. Aufwand und Routen

ArbeitAufwandEinstellen mit
kleine Korrekturen, Neu-Rendermittel/effort medium
ein neuer Filmsehr hoch/effort xhigh (der motion-reel-Skill setzt es für dich)
Flaggschiff erste 3 Sekunden eines Startsmaximal/effort max

/model bietet auch die Aufwandswahl bei der Auswahl von Opus 5.5. Route A (diese Engine) ist die Standardeinstellung. Verwende Remotion oder HyperFrames nur, wenn der Benutzer eines nennt; /motion-studio:seek-engine hat die Übergabe, einschließlich der Remotion-Lizenzschranke.

6. Schlüssel

Kopiere .env.example nur dann nach .env, wenn ein Schlüssel benötigt wird (Sprache: ELEVENLABS_API_KEY; Route-C-Bilder/Video: FAL_KEY). Sage dem Benutzer, er solle den Wert selbst in .env einfügen. Verweise in Eingabeaufforderungen und Protokollen nur auf den Variablennamen. .env ist bereits im .gitignore des Projekts.

7. Optionale Begleiter

Erwähne diese nur, wenn sie relevant sind. Installationsbefehle und Hinweise: references/companions.md.

BegleiterVerwende fürHinweis
claude-animation (buildwithhanif)handgezeichnet, Pinsel, Märchenbuch-OptikMIT; separater Node-Canvas-Renderer
HyperFrames (heygen-com)HTML + GSAP-KompositionenApache-2.0; Node 22+
RemotionReact-Serien und -VorlagenUnternehmenslizenz für gewinnorientierte Organisationen mit über 3 Mitarbeitern

Nächstes: Teste die Engine mit /motion-studio:showreel oder erstelle einen echten Film mit /motion-studio:motion-reel.

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

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

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