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
ultracodeein 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:
| Eingabe | Standard | Regel |
|---|---|---|
| Produkt-URL und -Name | erforderlich | das eigene Produkt des Benutzers oder eines, für das er die Rechte zur Promotion hat |
| Dauer | 20 s | 5 Story-Beats von 2 bis 4 s |
| Formate | 9x16 zuerst, dann 1x1, 16x9 | gleiche Timeline, neu gerahmt |
| CTA | fragen | genaue On-Screen-Wörter |
| Eine Beweisnummer | fragen | muss vom Benutzer oder seiner Website stammen; niemals eine erfinden |
| Musik | synthetisieren, 120 BPM | ein bereitgestellter Track benötigt eine Lizenz für diese Nutzung |
| Stimme / Maskottchen | keine | Stimme benötigt ELEVENLABS_API_KEY in .env |
| Referenz-Look | keiner | optional, ü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]
| Flag | Verwendung |
|---|---|
--viewports desktop,mobile | Standard; tablet auch verfügbar |
--full-page | hohe Screenshots zum Zuschneiden von Abschnitten |
--selector "<css>" | bestimmte Produktteile zuschneiden (wiederholbar): Hero, Preiskarte, Dashboard-Panel |
--dismiss-banners | einen 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-brand | Name, URL und die vorgeschlagenen Farben in studio.json schreiben |
--dark | das dunkle Design erfassen |
--no-fonts | den Schriftart-Download überspringen (Standard: die Web-Schriftarten speichern, die die Seite lädt) |
--allow-private | der 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-sandbox | Chrome 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 |
--json | eine 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
| Skript | Für | Schreibt |
|---|---|---|
states.mjs | ein abgedecktes Produkt (Modal, Zustimmung), eine App, die in einem inneren Bereich scrollt, einen Zustand hinter einem Klick, ein Element mit seinen berechneten Styles | assets/brand/states/<name>/: 00-first, 01-escape, scroll-NN, 10-click-..., crop-20-... PNGs und states.json |
canvas-frames.mjs | einen Bildschirm, der ein <canvas> ist, das sich pro Klick ändert und von selbst animiert | assets/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.sandboxzeichnet 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.jsonbrowser,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.blockedund einem Hinweis aufgelistet. Wenn die URL selbst abgelehnt wird, schlägt der Lauf fehl und speichert nichts. Übergeben Sie--allow-privatefü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.jsonoderstudio.jsonbrand.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:
- 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). - Bestätigen oder korrigieren Sie die Palette und Schriftarten, dann schreiben Sie
studio.jsonbrand. Die erfassten Schriftarten sind bereits inassets/fonts/, aber verwenden Sie nur eine, nachdem ihre Lizenz bestätigt wurde (UNVERIFIEDbedeutet, niemand hat geprüft). Vendor eine Google-Schriftart mitnpm 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". - 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 Siestudio.jsonaudio.musicdarauf und setzen Siebpmundduration. 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(oderminimalfür einen UI-lastigen Film). Es schreibtaudio/music.wavund eine analytischeaudio/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:
| # | Beat | Bild | Ton |
|---|---|---|---|
| 1 | Hook, 0 bis 2 s | das Problem in maximal 5 Worten großer kinetischer Schrift; Frame 0 bereits komponiert | Schlag auf den Downbeat |
| 2 | Produkt erscheint | die echte UI setzt sich Stück für Stück zusammen | Whoosh rein, Pops auf Teilen |
| 3 | Drei Funktionen | jeder ein UI-Moment mit einem Cursor, der eine echte Aktion ausführt | Klick auf jeden Druck |
| 4 | Beweis | die eine echte Zahl springt an ihren Platz | Tick oder Glocke |
| 5 | Lockup | Logo + CTA, finaler Hit auf dem letzten Downbeat | Riser 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,tauf einem Downbeat des Gitters aus Abschnitt 5, kurze Sätze. Führen Sienpm run voice -- --dry-runaus und teilen Sie dem Benutzer die Zeichenanzahl mit, bevornpm run voiceCredits 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.