Communitygithub.com

motion-spot

Erstelle hochwertige Motion-Design-Spots auf Agenturniveau (Produkt- und App-Werbung, Spec-Ads, Marken-Launches, Intros, Showreels) zu 100 % mit Code. Nutzt HTML, GSAP, CSS 3D und Three.js, gerendert Frame für Frame mit echtem Bewegungsunschärfe, Voice-Over und eigener oder komponierter Musik.

Was ist motion-spot?

motion-spot ist ein KI-Skill für Claude, Cursor und Codex, das es ermöglicht, professionelle Motion-Design-Spots (10–45 Sekunden) vollständig in Code zu erstellen – ohne Videobearbeitungssoftware. Der Skill basiert auf der Analyse von über 45 mit Claude produzierten Spots, die Millionen von Views erreicht haben. Das System rendert jeden Frame als Zustand einer Webseite: Eine pausierte GSAP-Timeline wird in einem fensterlosen Chrome Frame für Frame abgefahren, und ffmpeg komponiert daraus ein MP4 mit echtem Bewegungsunschärfe, Glühen und Filmkorn. Der gesamte Motor ist vorgefertigt und getestet und liegt als Vorlage bei. Der Workflow umfasst Konzeptfindung mit Spannungsbogen, Voice-Over-Scripting (ElevenLabs oder system-eigen), Musik-Komposition, Frame-für-Frame-Rendering und finale Audiomischung mit Ducking und LUFS-Normalisierung. Der Skill legt großen Wert auf markentreue Gestaltung: Interfaces werden nach echten Screenshots nachgebaut, Schriften aus dem Markenportfolio verwendet (kein generischer „Claude-Look“), und jede Szene wird durch eine Kamerafahrt sowie mehrere Motion-Design-Techniken (mindestens 8 pro Spot) belebt. Der Benutzer kann Referenzvideos mitbringen, die der Skill zunächst zerlegt und dann nachbaut, wobei er die Struktur, echte UI-Elemente und Typographie der Vorlage kopiert.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/santiagosantofimio/motion-spot/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

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“)

  1. 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).
  2. 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).
  3. 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.ttf aus SocialMedia/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.
  4. 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.
  5. Zeige ein Kontaktblatt deiner Version neben der Referenz und korrigiere Unterschiede vor der Auslieferung.
  6. 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 in motor/ui.js und motor/ui.css; vollständiges Beispiel in ejemplos/video-con-letra/.

Vor dem Start

Du musst Folgendes wissen; falls nicht klar, frage in einer einzigen Nachricht mit vorgeschlagenen Standardwerten:

  1. Was wird beworben und für wen (ein Satz).
  2. 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.
  3. Format und Dauer: 9:16 und 15 bis 20 s Standard. 16:9 für Web oder YouTube.
  4. Stimme: ElevenLabs (endgültig), say (Entwurf) oder ohne Stimme.
  5. 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 schreibt guion.tiempos.json mit 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:

  1. spot.escena('id', (capa, c) => { ... }) mit ihren drei Ebenen, ihrer Kamerabewegung und ihren Techniken.
  2. Synchronisiere mit der Stimme: spot.cuando('id', 'palabra').
  3. 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.mp4 und salida/spot-subida.mp4.
  • Cover: das Foto des eindrucksvollsten Moments, nicht das erste.
  • DECISIONES.md: Konzept, Archetyp, Entscheidungen, Verworfenes, Iterationen und Zeit (Vorlage in calidad.md).
  • Im Chat: der Pfad, was Entwurf ist (Stimme say, synthetisierte Musik) und 2 bis 3 konkrete Verbesserungen.

Unverbrüchliche Regeln

  1. Alles ist eine Funktion der Zeit t. Kein Math.random, Date.now, CSS-Animationen, setTimeout oder requestAnimationFrame im Spot. Für Zufall: ruido(i) oder azar(seed).
  2. Setze niemals transform in das CSS von etwas, das GSAP animiert (verwende stattdessen xPercent/yPercent). Das ist die häufigste Ursache für nicht ausgerichtete Elemente.
  3. Betrachte die Fotos jeder Szene, bevor du weitermachst. Es wird nichts ausgeliefert, was nicht gesehen wurde.
  4. Echte Assets oder es wird gesagt, dass es Beispiele sind. Oberflächen werden nach Screenshots originalgetreu nachgebaut, nicht „generisch“ erfunden.
  5. 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.
  6. Daten: Stammen vom Benutzer oder werden als illustrativ gekennzeichnet.
  7. 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.
  8. Kontext: Ein Spot verbraucht einiges. Wenn die Sitzung 40 % Kontext überschreitet, komprimiere, bevor du weiterbaust.
  9. Liedtexte: Claude schreibt sie nirgendwo hin (Code, letra.json, Chat), auch wenn der Benutzer sie übergibt. Für Videos mit Text: Zeiten in letra.json mit 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 in references/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

SymptomWahrscheinliche Ursache
window.spot.listo wird nie trueJS-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 springttransform im CSS plus GSAP; oder eine Klasse, die mit einer anderen kollidiert (.app); oder ein zu breiter Nachfahren-Selektor
Eine Szene erscheint weiß oder schwarzDie id ist nicht im Skript (führe preparar.mjs aus), oder ein Übergang hat die Ebene auf opacity: 0 gesetzt
Das 3D sieht flach austransform-style: preserve-3d fehlt in einem Zwischencontainer, oder es gibt ein overflow oder filter dazwischen
Stimme und Bild stimmen nicht übereinKorrigiere ± 0,1 s bei spot.cuando(...); überprüfe in servir.mjs mit Audio
Das Rendering dauert sehr langeVerwende --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 Konzeptvorlagen
  • references/calidad.md – Qualitätscheckliste und Vorlage für DECISIONES.md
  • references/diseno.md – Designrichtlinien und Variablen
  • references/encargo.md – Vorlage für vollständige Aufträge
  • references/estudio.md – Analyse der erfolgreichen Spots
  • references/lenguaje.md – Motion-Design-Techniken und -Sprache
  • references/motor.md – Motordokumentation, API und Fallstricke
  • references/referencia-fiel.md – Prozess und Bausteine für originalgetreue Nachbauten
  • references/voz-y-musica.md – Stimmen- und Musikproduktion
  • plantilla/ – Vollständige Projektvorlage mit Beispielspot „Turnito“
  • motor/ – Fertiger Render-, Musik- und Mixmotor
  • scripts/ – Hilfsskripte zur Projekterstellung

Verwandte Skills