Was macht motion-spot?
Erstellt Spots, die wie aus einer Agentur wirken – mit einer Methode, die aus der Analyse von 45 mit Claude produzierten Spots mit Millionen von Views abgeleitet wurde (references/estudio.md). Die Zutaten, die sich in allen wiederholen:
Ein Konzept mit Spannung (keine Liste von Funktionen) + die echte Oberfläche oder das echte Produkt als Hauptdarsteller + kinetische Typografie + eine Kamera, die niemals stillsteht + alles genau dann, wenn die Stimme es nennt + ein Höhepunkt in der Markenfarbe + ein sauberer Abschluss mit Logo und Slogan.
Alles ist Code: Jeder Frame ist der Zustand einer Webseite. Eine pausierte GSAP-Zeitleiste wird in einem fensterlosen Chrome Frame für Frame durchlaufen, und ffmpeg setzt das MP4 mit Bewegungsunschärfe, Glühen und Filmkorn zusammen. Der Motor ist bereits fertig und getestet in plantilla/motor/, mit einem vollständigen Beispielspot in plantilla/escenas.js.
Wenn der Benutzer ein Referenzvideo mitbringt („Mach dasselbe“)
- Zerlege die Referenz, bevor du gestaltest: 8 bis 12 Frames pro Sekunde der Schlüsselszenen in guter Größe (Kontaktblatt mit Read), notiere jedes Element: welche echte UI erscheint, welche Schrift, welche Farbe, wie sie ein- und ausgeht (strecken, unscharf, drehen).
- Kopiere die Struktur und die echten Elemente, kein „generisches Äquivalent“: Wenn das Original iMessage-Blasen verwendet, verwende
-apple-system(SF System) und eine Blase mit Schwanz; wenn es die Spotify-Songkarte verwendet, baue sie mit ihrem Label, Buttons und ihrer Farbe nach; wenn es ein riesiges Wort verwendet, ist es Arial Black (kommt mit macOS). - Typografie: Niemals die übliche. Der Benutzer hat die Standardschrift von Claude (enge schwarze Sans mit stark negativem Tracking, Inter, Serif Italic) mehrfach abgelehnt. Verwende die echte STATISCHE Schrift der Marke (z. B.
MonaSans-Black/Bold/Regular.ttfausSocialMedia/fuentes/, dieselben wie in Illustrationsvideos) mit normalem Tracking (höchstens -0,01 em), die Schrift aus der Referenz, falls vorhanden, oder frage / zeige 3 Proben vor dem Rendering. Niemals Variable Fonts mit mittlerer Strichstärke und engem Tracking. 3b. Der „Claude-Look“ ist standardmäßig verboten: Inter/Anton/Serif Italic/HUD Mono werden nur verwendet, wenn die Referenz oder die Marke sie verwendet. Mit Referenz werden deren Typografie und Elemente übernommen. - Fordere echte Screenshots an von Dingen, die nicht getreu nachgebaut werden können (App, Player, Cover): Der Benutzer legt sie in
activos/ab. Spotify und andere Apps können aus Richtlinien-Gründen für Steuerung blockiert sein: Die Blockade wird nicht umgangen, es wird der Screenshot angefordert oder ein öffentliches Bild verwendet und darauf hingewiesen. - Zeige ein Kontaktblatt deiner Version neben der Referenz und korrigiere Unterschiede vor der Auslieferung.
- Lies
references/referencia-fiel.md: vollständiger Prozess, Rezepte für jedes Element (Apple Messages-Blasen, Spotify-Songkarte, SVG-Steuerelemente, gleitende Schattierung) und die Fehler, die bereits Runden gekostet haben. Fertige Bausteine inmotor/ui.jsundmotor/ui.css; vollständiges Beispiel inejemplos/video-con-letra/.
Vor dem Start
Du musst Folgendes wissen; falls nicht klar, frage in einer einzigen Nachricht mit vorgeschlagenen Standardwerten:
- Was wird beworben und für wen (ein Satz).
- Echte Assets: Logo (am besten SVG), Screenshots der App oder Website, Produktfotos, Farben. Eine Website reicht auch. Ohne echte Assets wirkt die Marke generisch: Fordere sie immer an. Falls nicht vorhanden, wird eine Beispiel-Identität entworfen und dies mitgeteilt.
- Format und Dauer: 9:16 und 15 bis 20 s Standard. 16:9 für Web oder YouTube.
- Stimme: ElevenLabs (endgültig),
say(Entwurf) oder ohne Stimme. - Musik: vom Motor komponiert oder eigene Spur (für Veröffentlichung empfohlen).
Wenn der Benutzer einen vollständigen Auftrag mitbringt (references/encargo.md) oder sagt „Die Entscheidungen liegen bei dir“, frage nicht: produziere und erkläre im Anschluss in DECISIONES.md.
Ablauf
1. Projekt
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <spot-ordner> # mit dem Beispiel „Turnito“ als Referenz
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <spot-ordner> --clean # leeres Skelett
Kopiere die Vorlage, installiere Abhängigkeiten (ca. 10 s) und prüfe, ob Chrome verfügbar ist. Kopiere die Assets des Benutzers nach activos/.
2. Konzept und Archetyp
Lies references/arquetipos.md und wähle einen aus (plus einen geliehenen Shot für den Wow-Moment). Schreibe:
- Das Konzept in einem Satz mit seiner Spannung: „Das Chaos des Samstags gegen die Ruhe des Buchen in 3 Berührungen“.
- Die Markeneinsicht: ein Detail der Marke, das niemand sonst verwenden könnte (der Pfeil von Amazon, der A mit Z verbindet, der Swoosh, der den Bildschirm durchschneidet). Gibt es keine, wird der Spot generisch.
3. Voice-Over-Skript → guion.json
Lies references/voz-y-musica.md. Die Stimme wird vor der Animation geschrieben, denn sie gibt den Takt für alles vor. Ein Satz pro Szene, 2 bis 8 Wörter, mit Akzenten und Öffnungszeichen. Situationshaken („Es ist 2 Uhr morgens...“), Aktion, Nutzen, Höhepunkt und Marke + Slogan. Schreibe guion.json mit den Szenen, dem BPM, dem Musikstil, der pico-Szene und den Effekten.
4. Storyboard-Tabelle
Eine Tabelle, eine Zeile pro Szene: Zeit · Stimme · Held · Kamera · Motion-Design-Techniken (3 oder mehr aus references/lenguaje.md) · Ausgangsübergang. Regeln:
- Drei Ebenen pro Shot: bewegter Hintergrund + Held + Detail.
- Die Kamera bewegt sich immer. Motion-Design-Übergänge (Schnitt auf den Beat, Zoom-durch, Vorhang, Iris, Schub), keine Überblendungen.
- Ein Höhepunkt bei etwa 70 % in der Markenfarbe oder in 3D.
- Mindestens 8 verschiedene Techniken im Spot.
Wenn der Spot lang oder teuer ist, zeige dem Benutzer die Tabelle vor dem Bauen. Wenn er „Mach es“ gesagt hat, fahre fort.
5. Visuelles System → estilo.css
Lies references/diseno.md. Definiere Variablen (--fondo, --tinta, --acento, --acento2...) und die Klassen der nachgebauten Oberfläche mit eigenem Präfix (.ui ...). Typografie: enge schwarze Sans + ein Wort in Serif Italic + Mono für das HUD (sind bereits installiert: Inter, Instrument Serif, JetBrains Mono und Anton).
6. Stimme und Timing
- ElevenLabs: eine Generierung pro Szene →
audio/voz/<id>.mp3→node motor/preparar.mjs --recortar. - Entwurf:
node motor/preparar.mjs --borrador-voz. - Dann
node motor/preparar.mjs: misst die Stimmen, quantisiert die Schnitte auf den Puls und schreibtguion.tiempos.jsonmit der geschätzten Zeit jedes Wortes.
7. Szene für Szene bauen → escenas.js
Lies references/motor.md (API, Rezepte und bekannte Fallstricke). Pro Szene:
spot.escena('id', (capa, c) => { ... })mit ihren drei Ebenen, ihrer Kamerabewegung und ihren Techniken.- Synchronisiere mit der Stimme:
spot.cuando('id', 'palabra'). node motor/render.mjs --fotos <start+0.1>,<mitte>,<ende-0.1>und betrachte das Kontaktblatt (salida/fotos/hoja.jpg) mit Read. Korrigiere, bevor du weitermachst.
Verwende plantilla/escenas.js (Turnito) als Referenz für das Niveau: wie Occlusion, Orbit, Stundenrad, Benachrichtigungen, Voxel-3D, Vorhang und Zoom-durch gemacht werden.
8. Musik und Mix
node motor/musica.mjs # komponiert im BPM, mit Breakdown in der „pico“-Szene; oder verwende die eigene Spur aus guion.json
node motor/mezcla.mjs # Stimmen + Musik mit Ducking + Effekte, auf -14 LUFS
Mit node motor/servir.mjs kann der Benutzer die Vorschau mit Audio ansehen und durchgehen.
9. Rendern, Prüfen und Feinschliff
node motor/render.mjs --fotos # Kontaktblatt mit 12 Fotos: Komposition, Rechtschreibung und sichere Zonen
node motor/render.mjs --subida # final: 30 fps, 4× Unschärfe, Finish, plus die Kopie unter 10 MB (2 bis 3 Min. pro 20 s)
Gehe die Liste in references/calidad.md durch (drei Durchgänge). Mache dann eine Runde nur für den Feinschliff: sekundäre Mikroanimationen, Akzente auf Beats, erste und letzte Frames jeder Szene. Die zweite Runde ist es, die Gutes von Exzellentem trennt.
10. Auslieferung
salida/spot.mp4undsalida/spot-subida.mp4.- Cover: das Foto des eindrucksvollsten Moments, nicht das erste.
DECISIONES.md: Konzept, Archetyp, Entscheidungen, Verworfenes, Iterationen und Zeit (Vorlage incalidad.md).- Im Chat: der Pfad, was Entwurf ist (Stimme
say, synthetisierte Musik) und 2 bis 3 konkrete Verbesserungen.
Unverbrüchliche Regeln
- Alles ist eine Funktion der Zeit
t. KeinMath.random,Date.now, CSS-Animationen,setTimeoutoderrequestAnimationFrameim Spot. Für Zufall:ruido(i)oderazar(seed). - Setze niemals
transformin das CSS von etwas, das GSAP animiert (verwende stattdessenxPercent/yPercent). Das ist die häufigste Ursache für nicht ausgerichtete Elemente. - Betrachte die Fotos jeder Szene, bevor du weitermachst. Es wird nichts ausgeliefert, was nicht gesehen wurde.
- Echte Assets oder es wird gesagt, dass es Beispiele sind. Oberflächen werden nach Screenshots originalgetreu nachgebaut, nicht „generisch“ erfunden.
- Fremde Marken: Ein Spot einer echten Marke, die nicht dem Benutzer gehört, ist eine Portfolio-Übung („Spec“). Er wird nicht als offiziell veröffentlicht, es wird keine Verbindung zur Marke suggeriert und ihr Logo wird nicht verzerrt.
- Daten: Stammen vom Benutzer oder werden als illustrativ gekennzeichnet.
- Ich kann nicht hören. Ich überprüfe Pegel (Spitze von -1 bis -2 dB, -14 LUFS) und dass die Stimme über der Musik liegt; der Benutzer beurteilt nach Gehör.
- Kontext: Ein Spot verbraucht einiges. Wenn die Sitzung 40 % Kontext überschreitet, komprimiere, bevor du weiterbaust.
- Liedtexte: Claude schreibt sie nirgendwo hin (Code,
letra.json, Chat), auch wenn der Benutzer sie übergibt. Für Videos mit Text: Zeiten inletra.jsonmit leerem Text, Spot funktioniert mit und ohne Text, Validierung mit neutralen Phrasen in einer Testkopie, und der Benutzer fügt den Text ein und führt das finale Rendering aus. Details inreferences/motor.md→ „letra.json“.
Musikvideos und Videos mit Hintergrund
node motor/extraer.mjs <video> --desde S --hasta S extrahiert die Frames (activos/clip/) und das Audio des Ausschnitts; videoCuadros(...) zeigt sie synchronisiert; motor/letra.js macht das Karaoke aus letra.json. Archetyp 9 in references/arquetipos.md.
Wenn etwas schiefgeht
| Symptom | Wahrscheinliche Ursache |
|---|---|
window.spot.listo wird nie true | JS-Fehler in escenas.js: Das Rendering gibt die Fehler der Seite aus. Überprüfe die Imports und dass await spot.terminar() existiert |
| Ein Element erscheint nicht ausgerichtet oder springt | transform im CSS plus GSAP; oder eine Klasse, die mit einer anderen kollidiert (.app); oder ein zu breiter Nachfahren-Selektor |
| Eine Szene erscheint weiß oder schwarz | Die id ist nicht im Skript (führe preparar.mjs aus), oder ein Übergang hat die Ebene auf opacity: 0 gesetzt |
| Das 3D sieht flach aus | transform-style: preserve-3d fehlt in einem Zwischencontainer, oder es gibt ein overflow oder filter dazwischen |
| Stimme und Bild stimmen nicht überein | Korrigiere ± 0,1 s bei spot.cuando(...); überprüfe in servir.mjs mit Audio |
| Das Rendering dauert sehr lange | Verwende --blur 1 --escala 1.5 für Entwürfe; reduziere Knoten mit Schatten oder Unschärfe; verringere n in voxelOla oder particulas |
| Das MP4 ist zu groß | Das liegt am Filmkorn: --grano 3 oder --crf 22; für die Upload-Version --subida |
Referenzen
references/arquetipos.md– Archetypen und Konzeptvorlagenreferences/calidad.md– Qualitätscheckliste und Vorlage fürDECISIONES.mdreferences/diseno.md– Designrichtlinien und Variablenreferences/encargo.md– Vorlage für vollständige Aufträgereferences/estudio.md– Analyse der erfolgreichen Spotsreferences/lenguaje.md– Motion-Design-Techniken und -Sprachereferences/motor.md– Motordokumentation, API und Fallstrickereferences/referencia-fiel.md– Prozess und Bausteine für originalgetreue Nachbautenreferences/voz-y-musica.md– Stimmen- und Musikproduktionplantilla/– Vollständige Projektvorlage mit Beispielspot „Turnito“motor/– Fertiger Render-, Musik- und Mixmotorscripts/– Hilfsskripte zur Projekterstellung