Communitygithub.com

motion-build

Erstellt eine einzelne animierte Einblendung für Videos mit HyperFrames + GSAP im Kanal-Stil, standardmäßig im Stil v4 „Präsentation mit Bildern“.

Was ist motion-build?

Dieser Skill konzentriert sich auf die Erstellung einer einzelnen, abgeschlossenen Animation (4–10 Sekunden), die als Einblendung oder Overlay in ein Video eingefügt wird. Er basiert auf HyperFrames und GSAP und folgt standardmäßig dem v4-Stil „Präsentation mit Bildern“, der vom Autor als ideal bestätigt wurde. Der Skill enthält detaillierte Referenzen zu Stil, Techniken und Fallstricken, um konsistente und hochwertige Motion-Graphics zu gewährleisten. Er ist nicht für die Planung oder Orchestrierung ganzer Videos gedacht, sondern für einzelne Szenen, die von Agenten bearbeitet werden. Die Arbeit umfasst das Einrichten des Projekts, das Erstellen der Komposition mit präzisen Timings und Easing-Kurven, die Überprüfung durch automatisierte Tests und manuelle Sichtprüfung sowie das Rendern des finalen MP4. Der Skill betont die strikte Einhaltung von Design-System und Regeln, aber auch die eigenständige Entscheidungsfindung bei Unstimmigkeiten in der Spezifikation, wobei Abweichungen offen kommuniziert werden müssen.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/sstani-bgv/montage-skills/tree/HEAD/motion-build

In Ihrer bevorzugten KI fragen

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

Vorschau

Aus dem Skill-README

Dokumentation


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

  1. references/style-v4.md – wie es aussehen soll.
  2. 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.
  3. 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.
  4. references/design-system.md – Farbpalette, Skala, Komponenten, Markenregeln. Nicht verletzbar.
  5. 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.
  6. references/recipes/<technik>.html – funktionierende Implementierung aus techniques.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

  • check sauber, 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.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

sstani-bgv/montage-skills

Разметить motion-план для ролика (по умолчанию в стиле v4 «презентация с картинками»: kinetic-интро, спикер + достраивающаяся панель, картинки-метафоры, звук) — посмотреть транскрипт, скрипт или само видео и решить, в каких местах и какими приёмами визуально показать то, что автор проговаривает голосом. На выходе MOTION.md с таймкодами, выбранными приёмами и покадровыми спеками на каждую сцену. Используй этот скилл всегда, когда нужно понять, где в ролике нужны анимации, какие именно и почему, когда пользователь даёт транскрипт или ссылку на своё видео и спрашивает, что тут анимировать, а также когда надо переразметить уже существующий план. Сборкой занимается /motion-build, оркестрацией — /motion-run.

sstani-bgv/montage-skills

Сделать все анимационные вставки для ролика от начала до конца (по умолчанию в стиле v4 «презентация с картинками» — эталон, одобренный автором) — посмотреть видео или транскрипт, разметить motion-план, раздать сцены сабагентам, принять работу, собрать черновой монтаж со вставками поверх исходника и отдать его вместе с MP4 по таймкодам. Используй этот скилл всегда, когда пользователь просит сделать анимации для своего ролика, оживить видео вставками, «сделать как у такого-то блогера», собрать графику под уже записанный материал или довести ранее размеченный motion-план до готовых файлов. Это точка входа: сам зовёт /motion-plan для разметки и раздаёт сборку по /motion-build. Для одной отдельной анимации бери /motion-build напрямую.

Verwandte Skills