name: motion-build description: Erstelle eine einzelne animierte Einblendung für Videos mit HyperFrames + GSAP im Kanal-Stil. Standardmäßig im Stil v4 „Präsentation mit Bildern“ (vom Autor als ideal bestätigt, zwei russischsprachige YouTube-Referenzen): große Wörter im Intro, Sprecher + sich aufbauendes Panel, von Codex generierte 3D-Metaphernbilder, Soundeffekte bei jedem Erscheinen einer Grafik. Helles Farbschema, Onest/Unbounded; Akzente wie PiP-Morph, Rack-Focus, Kapitel-Karusselle, geschwindigkeitsangepasste Nähte, Zoom-Through, perspektivischer Fensterwechsel, Kaskaden mit Badges. Verwende diesen Skill immer dann, wenn du eine einzelne Animation/Szene/Motion-Einblendung nach einer fertigen Spezifikation erstellen, reparieren oder nachbessern musst, wenn ein Sub-Agent einen Auftrag für eine einzelne Szene aus einem Motion-Plan erhalten hat, oder wenn es um eine HyperFrames-Komposition für ein Video in diesem Stil geht. Nicht für die Planung des gesamten Videos – das ist /motion-plan – und nicht für die Orchestrierung – das ist /motion-run.
Erstellung einer einzelnen animierten Einblendung
Du erstellst eine einzelne, abgeschlossene Animation von 4–10 Sekunden, die als Einblendung in ein Video montiert oder als Overlay über ein Bild gelegt wird. Sie muss den Gedanken, den der Autor mit seiner Stimme ausdrückt, visuell zeigen – nicht allgemein illustrieren, sondern genau diesen Gedanken konkret darstellen.
Standardstil – v4 „Präsentation mit Bildern"
Wenn der Nutzer nichts anderes verlangt – erstelle im Stil v4. Der Autor nannte ihn „absolut ideal" und bat darum, dass zukünftige Videos genauso aussehen. Alles darüber steht in references/style-v4.md: Referenzen (Beschreibungen in references/style-v4.md), Layouts (kinetic / full / split-cam / split-screen / lower) mit exakter Geometrie, Konstanten, Sound, Abnahmekriterien.
- Gemeinsame Styles und Helfer:
assets/style-v4/common.css,common.js(heroIn,rise,chipIn,countUp). - Referenzszenen (Fragmente +
.sfx.json):references/recipes/v4/– beginne mit dem, das von Layout her am ähnlichsten ist. - Bauweise: Du schreibst ein Fragment
W/scenes/NN.html→python3 scripts/mk_scene.py W NN→check→ Render. Bilder:scripts/gen_images.sh+scripts/alpha.py; Webcam-/Bildschirmclips:scripts/cut_clips.py. - Soundeffekte für Stempel und „schlechtes Ergebnis" –
assets/style-v4/sfx/, der Rest ist im media-use-Bundle.
Alte Schicht (darunter): Techniken sind vom Schnitt von Austin Marchese abgeschaut und auf das Designsystem des Kanals übertragen – PiP-Morph, Zoom-Through, Kapitel-Karussell usw. In v4 werden sie als Akzente innerhalb einer Szene verwendet, nicht als Grundlage. Techniken werden exakt kopiert – Timing, Kurven, Ebenenreihenfolge; Farbpalette und Typografie stammen nur aus dem eigenen System.
Was und in welcher Reihenfolge lesen
references/style-v4.md– wie es aussehen soll.references/gotchas.md– bevor du Code schreibst. Dort sind Engine-Verbote, Fallstricke des hellen Farbschemas und Naht-Regeln. Jeder Punkt hat schon eine Iteration gekostet.references/style-rules.md– Stilgesetze: wie Text erscheint und verschwindet, was den Rhythmus vorgibt, was sich immer bewegt. Halte sie unabhängig davon ein, welche Technik du umsetzt – sie machen den Schnitt wiedererkennbar.references/design-system.md– Farbpalette, Skala, Komponenten, Markenregeln. Nicht verletzbar.- Mechanik deiner Technik – lies nur deinen Abschnitt:
references/techniques.md– Techniken mit getesteter Implementierung;references/techniques-observed.md– Techniken, die aus Analysen abgeleitet, aber noch nicht gebaut wurden; baue nach Beschreibung.
references/recipes/<technik>.html– funktionierende Implementierung austechniques.md. Dies ist keine vollständige Vorlage, sondern eine Referenz für die Lösung schwieriger Stellen. Schau dort nach, wenn die Mechanik nicht offensichtlich ist.
Die Spezifikation für die konkrete Szene kommt von /motion-plan oder direkt vom Nutzer.
Arbeitsablauf
1. Projekt vorbereiten
Wenn noch kein Projekt existiert:
./node_modules/.bin/hyperframes init <name> --example blank --non-interactive --resolution landscape --skill motion-graphics
Ein reines npx hyperframes im Repository-Stamm schlägt mit „Missing script" fehl – die CLI ist nicht global. Innerhalb eines bereits erstellten Projekts funktionieren npm run check und npm run render, von außerhalb wie oben über den Binärpfad.
Kopiere den Ordner assets/ dieses Skills vollständig in das Projekt, nicht Datei für Datei: tokens.css bindet Schriftarten über @import "./fonts/fonts.css" ein, und die Verzeichnisstruktur muss übereinstimmen.
cp -R <pfad-zum-skill>/assets/. <projekt>/assets/
Die Schriftarten Onest und Unbounded liegen lokal vor (Kyrillisch und Lateinisch), daher wird der Text auf jedem Rechner gleich gerendert. GSAP, die Startvorlage und alle Rezepte laden jedoch von CDN – Netzwerk wird beim Rendern dennoch benötigt. Falls kein Netzwerk vorhanden ist, lege gsap.min.js daneben und korrigiere <script src>.
Einbindung der Tokens in die Komposition – eine Zeile:
<link rel="stylesheet" href="./assets/tokens.css" />
2. Komposition erstellen
HyperFrames-Vertrag: Eine einzige paused-Timeline in window.__timelines["main"], jedes getimte Element mit class="clip", data-start und data-duration. Details unter /hyperframes-core, lade ihn, wenn du dir bei der Struktur unsicher bist.
Drei Dinge entscheiden, ob eine Technik gelingt:
Timings und Kurven kopiere wörtlich. Der Unterschied zwischen power2.inOut und power2.out beim PiP-Wachstum ist der Unterschied zwischen einer Kamerafahrt und einer Bildskalierung. Zwischen power3.inOut und power4.inOut bei einer Push-Naht liegt der Unterschied zwischen einem Gleiten und einem Ruck.
Halte die Technik, nicht den Buchstaben der Spezifikation. Wenn die Spezifikation einen bestimmten Easing-Wert angibt, die prozentuale Entwicklung aber nicht mit der Kurve übereinstimmt, hat die Kurve Priorität: Sie bestimmt, wie die Bewegung wahrgenommen wird. Wenn die Spezifikation eine Amplitude vorgibt, bei der das Objekt zum Zeitpunkt des Clip-Schnitts nicht aus dem Bild läuft, passe die Amplitude an die tatsächliche Geometrie von 1920×1080 an und erwähne dies.
Eine Technik, die nicht sichtbar ist, muss verstärkt werden. Eine formal korrekte, aber unsichtbare Umsetzung ist keine erledigte Arbeit. Ein Farbverlauf auf hellem Hintergrund ist fast unsichtbar, solange kein Frontmarker hinzugefügt wird. Eine Naht, bei der beide Seiten in der Mitte leer sind, hat nichts zu zeigen.
Wenn eine Technik weder in techniques.md noch in techniques-observed.md vorhanden ist – baue sie nach der Bild-für-Bild-Beschreibung aus der Spezifikation, aber finde zuerst die Weichenstellung: die Entscheidung, von der abhängt, ob das Bild gelingt. In der Regel ist dies keine Kurve, sondern eine Geometrie – um wie viel verschieben, wo liegt der Gruppenmittelpunkt, was verlässt den Bildrand. Die Spezifikation wird von jemandem geschrieben, der die Bilder nicht gesehen hat; die Weichenstellung hat er höchstwahrscheinlich übersehen. Triff die Entscheidung selbst, überprüfe anhand der Bilder und nenne sie unbedingt im Bericht – sie geht in den Skill des nächsten ein.
3. Prüfen
npm run check
Keine Fehler und keine Warnungen. Der Kontrast- und Layout-Audit wird sich über die Techniken selbst beschweren – unscharfer Hintergrund, überlappende Szenen in der Naht, gedämpfte Nachbarn. Unterscheide die Technik von einem echten Problem: Behebe echte Funde, markiere Techniken mit den standardmäßigen Opt-Outs. Jeder Opt-Out unterdrückt genau seine eigene Prüfung – Tabelle in gotchas.md, kein willkürliches Setzen: data-layout-ignore entfernt auch den Kontrast, und Text darunter fällt still aus dem Bericht.
Lege gleichzeitig eine Sidecar-Datei *.motion.json daneben – check erkennt sie automatisch und prüft die Bewegungsabsicht auf derselben gespulten Timeline, die auch der Renderer verwendet. Dies ist die nächstbeste automatische Alternative zu „rendern und ansehen": Sie erfasst einen Eingang, den das Spulen übersprungen hat, eine kaputte Stagger-Reihenfolge und einen eingefrorenen Standbild. Format in gotchas.md.
4. Mit eigenen Augen ansehen – dieser Schritt ist Pflicht
../node_modules/.bin/hyperframes snapshot . --frames 8 -o snapshots
Öffne snapshots/contact-sheet.jpg über Read – es ist ein Bild, du siehst es. check sagt dir nicht, dass ein Bild leer ist, der Text zu klein oder Blöcke wahllos angeordnet sind.
Betrachte Bild 0 separat – das ist der häufigste Fehler. Laut Stilgesetzen beginnt eine Szene bereits in Bewegung, nicht statisch oder aus der Leere; wenn auf Bild 0 Leere herrscht oder alles fertig dasteht, ist die Technik an der sichtbarsten Stelle kaputt.
Erstelle separat gezielte Bilder an den schwierigsten Punkten:
../node_modules/.bin/hyperframes snapshot . --at 1.45,1.55,1.675,1.8 --no-end -o snapshots-detail
Welche Punkte auswählen: Wenn die Technik eine Naht enthält – die Mitte der Naht und je ein Bild von jeder Seite. Wenn es keine Naht gibt, nimm Momente der Kompositionsänderung: Listenschrumpfung, Neuanordnung eines Blocks, Wechsel des aktiven Elements. Genau dort bricht das Layout, was auf acht gleichmäßigen Bildern nicht sichtbar ist.
Strittige Stellen (Farbverläufe, kleine Schriftgrößen) betrachte als PNG in voller Größe: Ein JPEG-Kontaktbogen lügt sowohl in der Größe als auch beim Banding.
Iteriere, bis das Bild gut ist. Die erste Version ist fast immer zu klein – das ist der häufigste Fehler, ein 1920×1080-Bild ist größer als es scheint.
5. Rendern
npm run render
Wohin mit der MP4
In renders/ deines Projekts und nirgendwo sonst. Gib den Dateipfad im Bericht an – die fertigen Einblendungen werden von demjenigen in die gemeinsamen Ordner einsortiert, der das gesamte Video zusammenbaut: Nur er weiß, wie sie auf der Timeline heißen und welche davon überhaupt akzeptiert wurden.
Dies ist keine Formalität. Bei einem Video haben neun Ersteller ihre Ergebnisse an drei verschiedenen Orten abgelegt, zwei haben renders/ komplett gelöscht, einer hat die Datei in zwei Ordner dupliziert „damit der Orchestrator sie auf jeden Fall findet“ – und der Orchestrator musste die Renders mit find auf der gesamten Festplatte suchen. Die Regel über „finale Videos in output/“ aus der CLAUDE.md bezieht sich auf fertige Videos, nicht auf Einblendungen für den Zusammenbau: Eine Einblendung ist ein Halbfabrikat.
Den Arbeitsordner des Projekts lösche ebenfalls nicht. Er wird vom Orchestrator gelöscht, sobald die Szene akzeptiert ist; bis dahin kann er für Korrekturen benötigt werden.
Overlay über dem Bild: Unterlage in die Komposition einbetten
Ein Overlay – Glasplatte, Titel, Glossar – ist auf ein bestimmtes Hintergrundbild ausgelegt und hat eine nicht offensichtliche technische Konsequenz: backdrop-filter sieht nicht, was nicht in der Komposition ist. Wenn das Overlay auf transparentem Hintergrund gerendert und im Schnittprogramm darüber gelegt wird, verwischt das Glas die Leere, es wird also nichts verwischt, und die Platte wird zu einer flachen Folie.
Daher wird eine Overlay-Komposition anders aufgebaut als eine Einblendung:
# Ein Stück des Quellmaterials exakt zum Timecode der Szene – in die assets des Projekts
ffmpeg -ss 20.0 -i <quellmaterial> -t 4.0 -vf "scale=1920:1080,fps=30" -an \
-c:v libx264 -crf 16 -preset veryfast -pix_fmt yuv420p -y assets/plate.mp4
<video id="plate" class="clip" data-start="0" data-duration="4" data-track-index="0"
src="./assets/plate.mp4" muted data-layout-ignore></video>
Die Unterlage kommt als nullter Track und wird mit data-layout-ignore markiert – sie wird nicht auditiert. Das Glas darüber funktioniert richtig. Am Ausgang entsteht ein normales MP4, das im Schnitt anstelle seines eigenen Stücks gesetzt wird, nicht darüber; der Ton aus der Unterlage ist entfernt, die Tonspur stammt vom Original.
Alternative – --format mov mit Transparenz – ist nur nötig, wenn der Cutter explizit Alpha wünscht und bereit ist, die Ebene selbst zu legen.
Was berichten
Kurz, 10–15 Zeilen: Was entstanden ist, Pfad zur MP4, welche Stellen schwierig waren und wie gelöst, was nicht ideal geblieben ist. Wiederhole keinen Code – er steht in der Datei.
Nenne Abweichungen von der Spezifikation ausdrücklich. Wenn du die Amplitude neu berechnet, die Kurve geändert oder ein Element hinzugefügt hast, das in der Spezifikation nicht stand – sage dies und erkläre warum. Die Spezifikation wird von jemandem geschrieben, der die Bilder nicht gesehen hat; du hast sie gesehen. Eine genannte Abweichung ist ein Fund; eine ungenannte ist eine Überraschung beim Schnitt.
Was als fertig gilt
checksauber, MP4 gerendert;- Die Technik ist auf den Bildern sichtbar, nicht nur „formal implementiert“;
- Farbpalette, Skala und Regeln des Designsystems eingehalten;
- Deterministisch: Zwei Aufnahmen des gleichen Timecodes ergeben denselben SHA-256, falls Pseudo-Zufälligkeit in der Szene vorhanden ist.