Communitygithub.com

yazzang-homelab/motion-studio

Marken-Asset-Bühne eines Produktfilms (Motion-Reel führt den gesamten Film aus): Echte Screenshots, Logo, Farben und Schriftarten von einer URL erfassen, UI nie neu zeichnen; Marken-Story-Beats; Stimme + Maskottchen. Verwenden, um Marken-Assets zu greifen oder zu korrigieren.

Was ist motion-studio?

Diese Fähigkeit (Skill) ist die Marken-Asset-Erfassungs- und Story-Beat-Phase einer Produkt-Motion-Reel-Pipeline, die nahtlos in die eigentliche Motion-Reel-Produktion übergeht. Sie ist als Kurs-Schritt 04 (Level L2) konzipiert und richtet sich an Entwickler, die mit Claude Code, Cursor oder ähnlichen KI-Agenten arbeiten. Der Skill automatisiert das Abrufen echter Produkt-Assets (Screenshots, Logo, Farbpalette, Schriftarten) von einer URL und extrahiert dabei sogar UI-Zustände und Canvas-Frames. Anschließend werden aus diesen Assets Komponenten erstellt, die animiert werden können (statt roher Screenshots), und die Musik- sowie Beat-Struktur wird an die Marke angepasst. Der Skill umfasst auch eine Story-Beat-Vorlage und optionale Sprach- sowie Maskottchen-Integration. Plattformunabhängig nutzbar; die Scripte benötigen nur Node.js und Playwright. Insbesondere ist er nützlich, wenn ein Benutzer die Marken-Assets schnell erfassen oder korrigieren möchte, ohne die UI neu zeichnen zu müssen, und die volle Reel-Produktion starten möchte.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Produkt-Reel (Kursschritt 04, Level L2)

Richten Sie das Studio auf ein Produkt aus, das der Benutzer tatsächlich verkauft. Die Showreel-Energie bleibt; der Inhalt wird zu seinem eigenen: echte Screenshots, das echte Logo, echte Farben und Schriftarten, echter Text, eine echte Zahl und Musik, der die Bewegung folgt. Alles nach der Markenstufe durchläuft die Standard-Motion-Reel-Pipeline.

Request-Argumente (können leer sein), einmal angezeigt; spätere Abschnitte sagen „die obige Anfrage“:

Umfang: Wenn der Benutzer nur die Assets erfassen oder korrigieren möchte, oder Sie von der Markenstufe der Motion-Reel hierher gekommen sind, führen Sie die Abschnitte 2 und 3 (und 4, falls gefragt) aus, melden und stoppen. Für einen vollständigen neuen Film folgen Sie jedem Abschnitt; die Abschnitte 5 bis 8 übergeben an die Motion-Reel-Pipeline.

Woher das Muster stammt

  • Tony Dinh (@tdinh_me) berichtete, dass eine TypingMind-Reel unter 30 Minuten dauerte, wo ein ähnliches Video ihn etwa 1.000 $ oder mehr ein Jahr zuvor gekostet hatte. Seine Eingabeaufforderung war der Showreel-Einzeiler plus vier kurze Richtungslinien: Produkt-URL einführen; die tatsächlichen Produkt-Screenshots, Logo und Assets verwenden; das Video muss Musik haben und die Bewegung muss dazu passen; machen Sie es zu einer echten professionellen Produktion, keinem Demo oder Prototyp. Er sagte, Claude habe die Marken-Assets selbst gesammelt.
  • Sein Follow-up bat darum, Screenshots in Komponenten und Symbole aufzuteilen, damit sie sich bewegen können, anstatt rohe Screenshots zu zeigen, und die Bewegung saftiger zu machen. Das ist die Komponentenregel unten.
  • Seine Eingabeaufforderung endete mit „Try again, ultracode." Im aktuellen Claude Code ist ultracode ein Schlüsselwort, das Claude veranlasst, einen Multi-Agenten-Workflow für die Aufgabe zu schreiben. Ob es sein Ergebnis beeinflusst hat, ist nicht dokumentiert; präsentieren Sie es nicht als Qualitätsschalter.
  • Rob Hallam (@robj3d3) erstellte eine zweite Reel für sein Produkt im selben Claude Code Chat wie seine erste. Der Kurs schließt daraus, dass die Engine wiederverwendet wurde; daher eine Sitzung und ein Projekt pro Marke.
  • Ein Gegenbeispiel: @mablesjoseph bat in einer Zeile um eine „slick and punchy" Promotion aus einem Ordner mit Assets, und das Ergebnis war „nicht gut genug, um geteilt zu werden". Die Richtung ist wichtiger als Assets allein.

1. Eingaben

Fragen Sie in einer Runde von AskUserQuestion nach, was die obige Anfrage nicht abdeckt:

EingabeStandardRegel
Produkt-URL und -Nameerforderlichdas eigene Produkt des Benutzers oder eines, für das er die Rechte zur Promotion hat
Dauer20 s5 Story-Beats von 2 bis 4 s
Formate9x16 zuerst, dann 1x1, 16x9gleiche Timeline, neu gerahmt
CTAfragengenaue On-Screen-Wörter
Eine Beweisnummerfragenmuss vom Benutzer oder seiner Website stammen; niemals eine erfinden
Musiksynthetisieren, 120 BPMein bereitgestellter Track benötigt eine Lizenz für diese Nutzung
Stimme / MaskottchenkeineStimme benötigt ELEVENLABS_API_KEY in .env
Referenz-Lookkeineroptional, über /motion-studio:reference-style

2. Projekt

Ein Projektordner (und idealerweise eine Sitzung) pro Marke. Wenn es keine studio.json gibt:

npm install @studio-init/scripts
node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <brand-slug>-reel --title "<Product> launch" --duration 20 --brand-url <URL> --install

Reine Skills-Installation: ${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs. Dann npm run doctor.

3. Die Marke erfassen

Führen Sie das Erfassungsskript vom Projektstamm aus (oder kurz motion-studio:asset-scout mit diesem genauen Befehl und dem Projektpfad):

node "${CLAUDE_SKILL_DIR}/scripts/capture.mjs" <URL> --root <project> --full-page [--selector "<css>"]... [--dismiss-banners]
FlagVerwendung
--viewports desktop,mobileStandard; tablet auch verfügbar
--full-pagehohe Screenshots zum Zuschneiden von Abschnitten
--selector "<css>"bestimmte Produktteile zuschneiden (wiederholbar): Hero, Preiskarte, Dashboard-Panel
--dismiss-bannerseinen offensichtlichen Cookie- oder Zustimmungsbutton im Wegwerf-Browser klicken (accept, agree, allow auf Englisch, Koreanisch, Japanisch, Chinesisch, Deutsch, Französisch oder Spanisch; schwache Bezeichnungen wie OK oder Close zählen nur innerhalb eines Banners oder Dialogs). Ein Hinweis im Manifest sagt, welcher Button geklickt wurde oder dass keiner passte
--apply-brandName, URL und die vorgeschlagenen Farben in studio.json schreiben
--darkdas dunkle Design erfassen
--no-fontsden Schriftart-Download überspringen (Standard: die Web-Schriftarten speichern, die die Seite lädt)
--allow-privateder Seite erlauben, Loopback, LAN und Link-Local-Adressen zu erreichen (Standard: nur der eigene Host und Port des Ziels); nur für eine Seite, der Sie vertrauen, wie ein lokaler Dev-Server des eigenen Produkts des Benutzers
--no-sandboxChrome ohne Renderer-Sandbox starten (auch MOTION_NO_SANDBOX=1; automatisch als Root auf Linux, wo Chrome damit nicht starten kann); ein Hinweis wird gedruckt, wann immer es ausgeschaltet ist
--jsoneine JSON-Ergebniszeile

Es schreibt assets/brand/screens/, assets/brand/logo/, assets/brand/components/, assets/brand/og-image.* und assets/manifest.json (Palette mit vorgeschlagenen Rollen, CSS-Farbvariablen, verwendete Schriftarten, Überschriften, Button- und Nav-Texte, Notizen). Bilderweiterungen kommen von den Bytes der Datei, und Komponenten-Zuschnitte außerhalb der Seite werden mit einem Hinweis übersprungen. Die Web-Schriftarten, die die Seite tatsächlich lädt, werden in assets/fonts/ gespeichert und in assets/fonts/fonts.json registriert (ein vorhandener Eintrag wird nie überschrieben); jeder hat eine license im Manifest, die UNVERIFIED bleibt, es sei denn, eine Lizenz-URL oder -Datei wurde gefunden, und das Skript druckt eine Erinnerung, sie vor der Veröffentlichung zu prüfen. Ein fehlgeschlagener Lauf behält die vorherige Erfassung. Details und das Manifest-Schema: references/asset-capture.md.

Logo und Typ. Wenn der Header kein Logo-Bild oder SVG hat, ist die Marke normalerweise ein Text-Wortmarke. Die Erfassung zeichnet es dann als Text in manifest.brand.wordmark auf (das Markup, Farben pro Teil mit Rollen, berechnete Schriftfamilie, -stärke, -größe und Buchstabenabstand) plus einen Referenz-Zuschnitt assets/brand/logo/wordmark-crop.png, und sagt dies in den Notizen, anstatt nur nach einer Logodatei zu fragen. Bauen Sie es aus diesem Datensatz wieder auf; fragen Sie nur nach einem SVG oder PNG, wenn der Film ein genaues Lockup benötigt.

Schriftarten. Die Logzeilen font registry: <family>: ... (und manifest.fonts.registry) geben für jede verwendete Familie an, ob sie bereits in assets/fonts/fonts.json ist und ob ihre Lizenz verifiziert ist (Lizenz-ID und Lizenztext aufgezeichnet) oder UNVERIFIED, und was dieser Lauf hinzugefügt hat. Ein Schriftschnitt, der neben einem verifizierten Eintrag derselben Familie ankommt, verwendet diese Lizenz wieder.

UI-Zustände und Canvas-Frames

capture.mjs macht eine Aufnahme beim Laden. Zwei Geschwisterskripte decken den Rest ab; beide drucken --help, schreiben nur innerhalb des Projekts (Standard assets/brand/), und laufen hinter demselben Sicherheitsstack (Headless-Shell auf Windows, Renderer-Sandbox an, private Adressen abgelehnt, Geheimnisse geschwärzt). Plugin-Installation: die Befehle unten. Reine Skills-Installation (kein ${CLAUDE_PLUGIN_ROOT}): die Skripte sitzen neben dieser Datei, also führen Sie node "${CLAUDE_SKILL_DIR}/scripts/states.mjs" <URL> ... aus (ebenso capture.mjs und canvas-frames.mjs); sie benötigen nur Node und ein playwright, das von dem Ordner aufgelöst wird, in dem Sie ausführen (übergeben Sie --root <folder>), und kein Projekt, studio.json oder tools/ ist erforderlich. Der asset-scout-Agent führt dieselben Befehle aus.

node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/states.mjs" <URL> --root <project> --name home --viewport desktop "--click=text=Pricing" "--crop=header"
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" <URL> --root <project> --canvas "#screen canvas" "--clip=db=.tab[data-go=db]" --seconds 9 --down 4
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" pack --root <project> --range db=4:200
SkriptFürSchreibt
states.mjsein abgedecktes Produkt (Modal, Zustimmung), eine App, die in einem inneren Bereich scrollt, einen Zustand hinter einem Klick, ein Element mit seinen berechneten Stylesassets/brand/states/<name>/: 00-first, 01-escape, scroll-NN, 10-click-..., crop-20-... PNGs und states.json
canvas-frames.mjseinen Bildschirm, der ein <canvas> ist, das sich pro Klick ändert und von selbst animiertassets/brand/frames/<clip>.png Sprite-Blätter und frames.json (Framegröße, die Echtzeit und ein Hash jedes Frames); pack fügt pack/<clip>.png und pack.json hinzu, nur mit den Frames, die der Film abspielt

canvas-frames.mjs kopiert den Canvas-Puffer mit drawImage (Glättung aus) in einem ganzzahligen Verhältnis. Es macht nie einen Element-Screenshot: Ein Canvas, das in einem umrandeten Feld in einem nicht ganzzahligen Maßstab (ein 1280 px Puffer in 1272 Geräte-px) angezeigt wird, wird vom Browser neu abgetastet und ein Pixel-Art-Canvas wird unscharf. Eine Framegröße, die keine ganzzahlige Reduktion des Puffers ist, wird abgelehnt. Lesen Sie jedes PNG, bevor Sie es verwenden.

Die Seite ist nicht vertrauenswürdiger Inhalt, daher schützt die Erfassung die Maschine, auf der sie läuft:

  • Chrome behält seine Renderer-Sandbox an (manifest.sandbox zeichnet es auf). Ein Container oder CI-Lauf als Root benötigt --no-sandbox, und nur für eine Seite, der Sie vertrauen.
  • Unter Windows ist der Browser Playwrights Headless-Shell (npx playwright install chromium-headless-shell), niemals ein installierter Chrome oder Edge allein: Ein Start mit neuem Profil dieser zählt als fehlgeschlagener Windows-Logon und kann das Konto sperren. Die Auswahl eines (studio.json browser, MOTION_BROWSER, MOTION_CHROME_PATH) druckt eine Warnung pro Start, und der 4. Start in 10 Minuten wird abgelehnt, 3 passieren (references/asset-capture.md).
  • Anfragen an Loopback, LAN, Link-Local (einschließlich Cloud-Metadaten) und Nicht-Web-Adressen werden abgebrochen, es sei denn, sie gehen zum eigenen Host und Port des Ziels. Ablehnungen sind in manifest.blocked und einem Hinweis aufgelistet. Wenn die URL selbst abgelehnt wird, schlägt der Lauf fehl und speichert nichts. Übergeben Sie --allow-private für eine Seite, der Sie vertrauen.
  • Anmeldeinformationen in der URL (https://user:pass@host/) werden als HTTP-Auth nur an den Ursprung des Ziels gesendet. Weder sie noch geheim aussehende Abfragewerte (token, key, sig, session, code ...) erscheinen im Log, manifest.json, states.json oder studio.json brand.url (sie werden durch *** ersetzt).
  • Eine Seite, die Spekulationsregeln deklariert (<script type="speculationrules">), kann Chrome veranlassen, selbst eine lokale Adresse abzurufen, was kein Anfragefilter sieht; das Manifest vermerkt es. Erfassen Sie keine Seite, der Sie nicht vertrauen, auf einer Maschine mit sensiblen lokalen Diensten.

Dann, vor jeder Animation:

  1. Listen Sie dem Benutzer auf, was gefunden wurde: Screens, Logokandidaten, vorgeschlagene bg/fg/accent/muted, Schriftarten, Überschrift und CTA-Text, und jede Notiz (Bot-Check, fehlendes Logo).
  2. Bestätigen oder korrigieren Sie die Palette und Schriftarten, dann schreiben Sie studio.json brand. Die erfassten Schriftarten sind bereits in assets/fonts/, aber verwenden Sie nur eine, nachdem ihre Lizenz bestätigt wurde (UNVERIFIED bedeutet, niemand hat geprüft). Vendor eine Google-Schriftart mit npm run fonts -- add "Family:400,700"; eine kommerzielle Schriftart benötigt die eigene Lizenz oder Dateien des Benutzers. Koreanisch oder anderer CJK-Text benötigt eine Schriftart, die die Glyphen hat: npm run fonts -- coverage --text "..." --family "Name".
  3. Fragen Sie nach allem Fehlenden, anstatt es zu erfinden: ein SVG-Logo, den genauen Akzent-Hex, einen Screenshot hinter einer Anmeldewand.

4. Komponenten, keine rohen Screenshots

  • Schneiden Sie Teile der erfassten Screens in separate Bilder (--selector, oder die automatischen Zuschnitte: Header, Hero, CTA-Buttons, Karten, Produktbilder, Preise, Abschnitte). Animieren Sie die Teile: Karten gleiten in ein Layout, ein Button drückt, ein Diagrammfeld zeichnet.
  • Bauen Sie einfaches UI-Chrom (einen Button, einen Toggle, ein Feld) auf der Leinwand mit den echten Farben, dem Text und dem Radius, gemessen vom Zuschnitt, wieder auf. Das ist Neusetzen, nicht Erfinden: Layout, Beschriftungen und Daten müssen genau dem Produkt entsprechen.
  • Zeichnen Sie niemals Produktbildschirme, die nicht existieren. Kein Platzhaltertext, kein Lorem Ipsum, keine gefälschten Zahlen. Wenn ein benötigter Bildschirm fehlt, fragen Sie danach.

5. Musik und Beat-Gitter (vor der Shot-Liste)

Zeitlich alles auf dem echten Gitter, also messen oder synthetisieren Sie die Musik, bevor jemand einen Shot schreibt:

  • Bereitgestellter Track: node tools/beats.mjs audio/<track>, dann zeigen Sie studio.json audio.music darauf und setzen Sie bpm und duration. Sein erster Downbeat kann gut nach 0 s oder mit einem anderen Tempo als 120 liegen, und die Shot-Liste muss dem folgen, niemals einem angenommenen Gitter.
  • Kein Track: node tools/score.mjs --style pulse --bpm 120 --dur 20 (oder minimal für einen UI-lastigen Film). Es schreibt audio/music.wav und eine analytische audio/beats.json.
  • Jeder sichtbare Hit bekommt einen Cue; die Bewegung folgt der Musik, nicht umgekehrt.

6. Story-Beats

Füllen Sie die Markengeschichte in assets/brand-prompt.md mit den Fakten des Benutzers und übergeben Sie sie an motion-studio:motion-director für docs/shotlist.md; der Director liest audio/beats.json, also kommt Abschnitt 5 zuerst. Standard 20 s bei 120 BPM, ein Beat pro 2 bis 4 s, Szenenwechsel auf Downbeats:

#BeatBildTon
1Hook, 0 bis 2 sdas Problem in maximal 5 Worten großer kinetischer Schrift; Frame 0 bereits komponiertSchlag auf den Downbeat
2Produkt erscheintdie echte UI setzt sich Stück für Stück zusammenWhoosh rein, Pops auf Teilen
3Drei Funktionenjeder ein UI-Moment mit einem Cursor, der eine echte Aktion ausführtKlick auf jeden Druck
4Beweisdie eine echte Zahl springt an ihren PlatzTick oder Glocke
5LockupLogo + CTA, finaler Hit auf dem letzten DownbeatRiser in einen Hit

Zeigen Sie die Shot-Liste und warten Sie auf das OK des Benutzers (PLAN FIRST), es sei denn, sie haben um den autonomen Modus gebeten. Wenn sich das Gitter später ändert (ein anderer Track, ein anderes bpm oder duration), timen Sie die Liste neu und zeigen Sie sie erneut.

7. Stimme und Maskottchen

  • Stimme (optional): schreiben Sie audio/voice.json (siehe assets/voice-script.example.json): eine Zeile pro Beat, t auf einem Downbeat des Gitters aus Abschnitt 5, kurze Sätze. Führen Sie npm run voice -- --dry-run aus und teilen Sie dem Benutzer die Zeichenanzahl mit, bevor npm run voice Credits ausgibt (eine identische Zeile wird einmal synthetisiert und berechnet). Der Mixer duckt Musik unter der Stimme.
  • Maskottchen (optional): eine Figur, die in Code gezeichnet wird, mit einer festen Identität (Form, Palette aus der Marke entnommen, Proportionen), die auf Beats mit der playful-Feder reagiert. Halten Sie das sam

…

[für die Übersetzung gekürzt]

8. Motion-Reel-Pipeline

Nachdem die Marken-Assets erfasst und die Geschichte ausgefüllt sind, übergeben Sie die Kontrolle an motion-studio:motion-director. Dieses Tool generiert die vollständige Shot-Liste und übergibt sie an die Render-Engine. Alle erforderlichen Assets befinden sich jetzt im Projektordner: assets/brand/, assets/fonts/, audio/ und docs/shotlist.md. Der Director verwendet die Markeninformationen, um die visuellen Effekte, Animationen und Übergänge zu steuern. Der Benutzer sollte die vollständige Pipeline mit npm run motion oder einem ähnlichen Befehl ausführen können, abhängig von der spezifischen Einrichtung. Stellen Sie sicher, dass alle Lizenzprüfungen für Schriftarten und Musik abgeschlossen sind, bevor Sie rendern. Der Director meldet mit motion-studio:report den Status der Erfassung, der Shot-Liste und des endgültigen Renderings. Wenn der Benutzer nur die Assets erfasst oder korrigiert hat, melden Sie mit motion-studio:report die Ergebnisse der Schritte 2 und 3.

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

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