Communitygithub.com

shutckin/aivfx-content-kit

Erstellt Bewegungsgrafiken auf der HyperFrames-Engine (HTML-Szenen, die zu Video gerendert werden) mit einer AIVFX-Studio-Ebene: Namenseinblendungen, Kapitel, Zahlen, Shorts- und Reels-Hooks, Endkarten, Titel. Die Marke (Farben, Schriftarten, Bewegung, Dauern) lebt in einer Datei, das Video ist ein Briefing der Szenenrollen, Bewegung wird in Worten festgelegt, und der Agent rendert einen Entwurf über Footage und einen finalen ProRes 4444 mit Alpha. Bietet Timing-Regeln, 9:16- und 16:9-Sicherheitszonen, Lint- und Blackframe-Prüfungen, eine Übergabe-Checkliste und einen Brand-Datei-Checker. Auslöser: 'lower third', 'motion graphics', 'chapter card', 'shorts hook', 'end card', 'transparent overlay', 'brand kit for motion', 'HyperFrames'.

Was ist aivfx-content-kit?

Diese KI-Agent-Fertigkeit automatisiert die Erstellung von Bewegungsgrafiken für Videos mithilfe der HyperFrames-Engine, die HTML-Kompositionen in Videos rendert. Sie ist auf mehreren Plattformen wie Claude Code und ähnlichen Code-Agenten verfügbar und verwaltet das gesamte Branding über eine zentrale `brand.json`-Datei, die Farben, Schriftarten, Bewegungsparameter und Dauern definiert. Das System arbeitet mit einem Rollen-basierten Briefing (`scenes.json`), in dem jede Szene eine Rolle (z. B. 'hook', 'name', 'chapter') erhält, die automatisch in eine entsprechende HyperFrames-Vorlage übersetzt wird. Die Bewegung wird in natürlicher Sprache statt in Code beschrieben, wodurch Agenten und menschliche Redakteure leicht zusammenarbeiten können. Der Agent rendert zunächst einen schnellen Entwurf, der über das eigentliche Footage gelegt wird, um Probleme zu erkennen, und erstellt dann einen finalen ProRes 4444 MOV mit Alpha-Kanal für die Bearbeitung in DaVinci Resolve, Premiere Pro oder Final Cut Pro. Integrierte Prüfungen wie Linting, Blackframe-Erkennung und eine Brand-Datei-Validierung stellen sicher, dass die Ausgabe professionellen Standards entspricht. Die Skill eignet sich ideal für konsistente untere Drittel, Kapitelkarten, Nummern, Hooks für Shorts/Reels und Endkarten, jedoch nicht für vollflächige Promo-Videos mit eigener Erzählung.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shutckin/aivfx-content-kit/tree/HEAD/skills/motion-graphics

In Ihrer bevorzugten KI fragen

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

Dokumentation

MoGraph für Videos

Anleitung auf Russisch. Antworten in der Sprache des Benutzers.

Warum

Einblendungen, die einzeln „nach Augenmaß“ erstellt werden, unterscheiden sich bereits bei der dritten: Die eine kommt von unten in einer halben Sekunde, die andere von der Seite in einer Sekunde, die Schrift ist zwei Punkte größer, der Akzent hat einen anderen Farbton. Der Zuschauer formuliert das nicht, aber das Video wirkt wie aus fremden Teilen zusammengesetzt.

Die Motion-Studios basieren auf HyperFrames, und das Studio hat es zu seiner eigenen Fabrik weiterentwickelt: Markenentscheidungen werden einmal getroffen und in einer Datei gespeichert, das Video wird als Briefing mit Szenenrollen beschrieben, und der Agent verwandelt das Briefing in Kompositionen und rendert sie. Eine neue Einblendung wird genauso wie die anderen, selbst wenn sie von einem anderen Agenten einen Monat später erstellt wird.

Worauf es basiert

ToolWarum es hier istWas aus was
HyperFramesEngine: Szene ist HTML-Komposition, Rendering zu Video, eigene PrüfungenHTML, CSS und GSAP-Timeline → MP4, WebM oder MOV ProRes 4444 mit Alpha
Claude Code (oder Äquivalent)Agent erstellt Szenen nach BriefingBriefing + Brand-Datei → Kompositionen, Rendering, Prüfungen
Brand-DateiEin Ort für Farben, Schriftarten, Bewegung, Ränderbrand.json → Werte für jede Szene
ffmpegEntwurf über Footage, Frame-Liste, Suche nach schwarzen FramesSzenen mit Alpha + Videoframes → Vorschau und Frame-Liste
ProRes 4444Finale mit transparentem Hintergrund für den SchnittMOV mit Alpha-Kanal
DaVinci Resolve (oder Äquivalent: Premiere, Final Cut)Schnitt, Grafik wird über das Video gelegtMOV ProRes auf Spur über Footage

Der Agent schreibt Plan, Briefing, Kompositionen und führt Prüfungen durch; der Eigentümer genehmigt Plan und Entwurf; Texte (Namen, Zahlen) liefern Eigentümer oder Kunde.

HyperFrames ist eine Open-Source-Engine von HeyGen: https://hyperframes.heygen.com. Eine Komposition ist dort eine HTML-Datei mit data-*-Attributen für Timing, einer GSAP-Timeline für Animation und CSS für das Aussehen. Node.js 22 oder neuer und ffmpeg werden benötigt.

Was HyperFrames selbst bietetWas das Studio hinzugefügt hat
HTML-Komposition mit Spuren und Szenen-TimingBrand-Datei: Farben, Schriftarten, Bewegung, Ränder; Markenregeln werden vor jedem Rendering ausgegeben
hyperframes init, preview mit Studio im BrowserVideo-Briefing nach Szenenrollen statt manuellem Layout jeder Komposition
hyperframes render: MP4, WebM und MOV ProRes 4444 mit Transparenz (--format mov), --quality draftRollen- und Vorlagenbibliothek: Rolle wird in eine markenspezifische Vorlage übersetzt, ein Briefing wird im Stil jeder Marke erstellt
hyperframes lint, check und validate: Markup- und Timeline-Fehler, Browser-Fehler, fehlende Dateien, TextkontrastEntwurf über echtem Footage und Kontaktbogen statt Bewertung auf Schwarz
hyperframes add: vorgefertigte Blöcke und Effekte aus dem RegisterVergleich des Finales mit dem Entwurf auf dunkle Frames und Suche nach schwarzen Frames
hyperframes doctor: Umgebungsprüfungcheck_brand.py: Überprüfung der Brand-Datei vor der ersten Szene
--docker für konsistente Ergebnisse auf verschiedenen MaschinenLokale Schriftarten, in die Komposition eingebettet, und lokaler GSAP, Dateinamen nach Szenen

Die folgenden Prinzipien gelten auch für andere Engines, die Code in Video umwandeln.

Wann einschalten

Grafik in ein Video (Sprechername, Kapitel, Zahl, Endkarte), Hook für Shorts und Reels, transparente Overlays für den Schnitt, neue Marke für Grafik.

Nicht einschalten für vollflächige Promo-Videos von 10–25 Sekunden mit eigener Geschichte: Hier wird ein Storyboard zum Musik-Tempo benötigt, eine eigene Komposition pro Video, und Szenenrollen stören nur. Das Storyboard für Videos erstellt shot-list, Cover für Artikel article-cover, den Stil generativer Frames film-look.

Drei Dateien statt einer großen

  1. Brand-Datei brand.json: Farben, Schriftarten, Textgrößen, Bewegungsvokabular, Rollendauern, Ränder und Sicherheitszonen. Eine pro Marke, selten geändert. Beispiel mit fiktiver Marke und Kommentar zu jedem Feld: templates/brand.example.json.
  2. Video-Briefing scenes.json: Liste der Szenen nach Rollen. Nur Bedeutung und Texte, keine Farbe und keine Bewegungszahl. Beispiel: templates/scenes.example.json.
  3. Rollen-Vorlage: Pro Rolle eine HyperFrames-Komposition, die Marke und Szene liest und die Werte einsetzt. Eigene Vorlagen schreibt man selbst, das ist wenig Aufwand pro Rolle. Guter Start: hyperframes init und vorgefertigte Blöcke aus dem Register über hyperframes add.

Die Hauptregel: Eine Farbe, Schriftart oder Geschwindigkeit, die nur eine Szene benötigt, aber nicht in der Marke festgelegt ist, ist ein Signal. Entweder in der Marke für alle ergänzen oder darauf verzichten. Eine „nur hier“-Anpassung ist genau das, was das System zerstört. Ein neuer Typ wird benötigt: Erstelle eine neue Vorlage, anstatt die allgemeine für ein Projekt anzupassen.

So richtest du eine Brand-Datei ein

  1. Kopiere templates/brand.example.json als brand.json in das Projekt.
  2. Nimm Farben von der Website oder aus den Markenrichtlinien. Keine Richtlinien: Frage den Eigentümer nach Hintergrund, Haupttext und Akzent. Erfinde keine Markenfarben für den Kunden.
  3. Gib jeder Farbe einen Wert: Hintergrund, Text, zweite Zeile, Akzent. Wenn du nicht sagen kannst, wofür die Farbe benötigt wird, ist sie überflüssig. Fünf aktive Farben sind die Obergrenze.
  4. Schriftarten: Eine für Überschriften und Zahlen, eine für Untertitel, eventuell eine für alles. Nur Sans oder Serif. Monospace- und Pixel-Schriftarten werden nirgendwo verwendet, auch nicht für Zahlen, Daten und Labels. Zahlen werden in einer serifenlosen Schrift mit gleichbreiten Ziffern gesetzt: in CSS font-variant-numeric: tabular-nums. Der Zähler springt nicht mehr, und die Schrift bleibt lebendig.
  5. Bette Schriftarten in die Komposition ein (als Datei aus dem Projekt oder direkt in CSS). Eine Schrift aus dem Internet könnte zum Zeitpunkt des Renderings nicht geladen sein, und Frames werden mit System-Schriftarten ausgegeben. Gleiches gilt für GSAP: Halte es lokal, der Ladevorgang aus dem Netzwerk könnte mitten im Rendering ausfallen.
  6. Schreibe in rules die Markenbeschränkungen in Worten: Wie der Akzent verwendet wird, ob neue Farben eingeführt werden dürfen, woher Fakten kommen. Der Agent liest sie vor jedem Build, sonst gehen sie zwischen den Sitzungen verloren.
  7. Führe die Prüfung aus:
python3 scripts/check_brand.py brand.json

Das Skript sucht nach Pflichtfeldern, Farben, die nicht im Hex-Format sind, Textkontrast zum Hintergrund unter 4.5:1, Monospace- und Pixel-Schriftarten, Text kleiner als 28 Pixel auf einem 1080-Frame, Dauern außerhalb vernünftiger Grenzen und Sicherheitszonen, die die Plattform-Oberfläche nicht abdecken. Exit-Code 1 bei Verstößen.

Szenenrollen

Beschreibe die Rolle, nicht die Vorlage. Die Rolle sagt, wozu die Szene dient, und die Vorlage wählt die Marke aus. Wechsle die Marke, und dieselbe Rolle wird in einem anderen Stil zusammengestellt, ohne das Briefing umschreiben zu müssen.

RolleWozuFelderHintergrundDauer
hookErste 1-3 Sekunden Shorts, Finger haltentitle (3-6 Wörter), subtitle optionalEigen, Vollbild2-3 s
nameWer im Bild sprichttitle (Name), subtitle (Rolle)Transparent3-5 s
chapterWechsel des Sinnabschnittslabel (Nummer), titleEigen oder transparent2.5-4 s
numberEine zu merkende Zahlvalue, unit, noteTransparent3-4 s
endcardFinale: Name, Website, Handlungsaufforderungtitle, meta, LogoEigen, Vollbild4-6 s

Ein kurzer Fakt, eine Ecknotiz oder eine Aufzählung mit Trennzeichen können ebenfalls Rollen sein (fact, note, list). Erstelle eine neue Rolle, wenn dieselbe Aufgabe zum zweiten Mal auftritt, nicht für eine einzelne Szene.

Position im Bild at: bl, br, tl, tr, left, right, center. Eine Namenseinblendung ist fast immer unten links, auf der dem Blick des Sprechers gegenüberliegenden Seite.

Texte nur aus dem Briefing. Namen, Titel, Zahlen und Adressen werden nicht erfunden: Keine Daten vorhanden, frage nach. Ein Fehler im Nachnamen auf einer Einblendung fällt jedem Zuschauer auf.

Bewegung in Worten

In der Szene wird die Bewegung wie ein Regisseur beschrieben, nicht wie ein Programmierer:

Die Akzentlinie zeichnet sich von links ein, der Name hebt sich dahinter an, der Titel erscheint danach; hält; alles geht mit einer Bewegung nach unten

Der Agent übersetzt dies in Markenwerte und GSAP-Tweens: „hebt sich an“ ist eine Verschiebung um motion.travel_px in motion.enter_sec mit einer Verlangsamung ease_enter, „danach“ ist eine Pause stagger_sec, „geht“ ist exit_sec. Wenn die Beschreibung das benötigte Wort nicht enthält, nimm die Standardeinstellungen der Marke, anstatt eine Geschwindigkeit zu erfinden.

  • Ein Gedanke pro Szene. Wenn eine Szene zwei Dinge sagt, sind es zwei Szenen.
  • Zuerst der finale Frame, dann die Bewegung. Gestalte die Szene in dem Moment, in dem alles an seinem Platz ist, und füge erst dann Ein- und Ausgang hinzu. So sind Überlagerungen vor dem Rendern sichtbar.
  • Eingang langsamer als Ausgang. Erscheinen mit Verlangsamung, Verschwinden mit Beschleunigung und etwa doppelt so schnell. Der Zuschauer folgt dem Eingang, der Ausgang ist ihm egal.
  • Eine Richtung pro Video. Eingang von unten, Ausgang nach unten oder oben auf derselben Achse. Richtungschaos wirkt wie ein Schnittfehler.
  • Nicht mehr als zwei Techniken pro Szene. Verschiebung und Einblendung sind bereits genug. Rotation, Abprallen und Unschärfe auf einmal sind ein Demo-Reel der Engine.
  • Kurze Distanzen, Elemente nacheinander. Eine Verschiebung um 30-60 Pixel wirkt teuer, über den halben Bildschirm billig. Linie, dann Name, dann Titel.
  • Hook nach Wörtern, nicht nach Buchstaben. Buchstabenweise ist langsam und stört beim Lesen.
  • Das Finale hält 3-4 Sekunden still, sonst kann es nicht gelesen werden.
  • Keine Zufälle im Code. Zufallszahlen und aktuelle Uhrzeit ergeben bei jedem Rendering ein anderes Bild. Streuung nimmst du von der Elementnummer.

Timing und Lesbarkeit auf dem Telefon

  • Text bleibt nach vollständigem Erscheinen mindestens min_hold_sec lang still.
  • Lesezeit: etwa 0,3 Sekunden pro Wort plus Eingangszeit. Eine Einblendung mit sechs Wörtern lebt nicht weniger als drei Sekunden.
  • Text mittlerer Größe. Eine riesige Überschrift über den ganzen Bildschirm wirkt wie ein Schrei.
  • Kurze Seite 1080 Pixel: Überschrift 64-110, Titel nicht kleiner als 40, Label nicht kleiner als 28. Kleiner ist auf dem Telefon nicht lesbar.
  • Zeile bis zu 25-30 Zeichen. Lange Zeilen nach Sinn aufteilen, nicht nach Breite.
  • Text über Footage immer mit Unterlage, Schatten oder Abdunkelung. Kontrast 4.5:1 wird zur Unterlage berechnet, nicht zum leeren Hintergrund.
  • Akzent auf ein Wort oder eine Linie. Ein mit Akzent gefüllter Absatz ist nicht lesbar.
  • Die Timeline einer Szene muss ihren Slot vollständig ausfüllen: Am Ende füge einen leeren Tween für die gesamte Szenendauer hinzu. Sonst blendet HyperFrames die Szene früher aus, und im Video erscheint ein schwarzer Frame.

Sichere Zonen

Plattformen überdecken einen Teil des Bildes mit ihrer Oberfläche. Die Zahlen gelten für ein Bild mit einer kurzen Seite von 1080, überprüfe sie anhand eines aktuellen Screenshots der Plattform.

9:16 (1080x1920, Shorts, Reels, TikTok): Oben etwa 250 Pixel (Name, Buttons), unten etwa 400 (Untertitel, Musik, Fortschritt), rechts etwa 140 (Likes und Kommentare), links etwa 60. Hook und wichtigen Text in den mittleren Streifen setzen. Eine Namenseinblendung im Hochformat wird höher als üblich gesetzt.

16:9 (1920x1080, YouTube, horizontales Video): Seitlich etwa 96 Pixel, oben 54, unten etwa 96. In den letzten 5-20 Sekunden platziert YouTube Endcards, die Endkarte muss mit Platz dafür gebaut werden.

Die Zonen leben in der Brand-Datei, die Szene wird durch Überlagerung eines Rahmens auf einem Entwurfsframe überprüft.

Rendern

  • Entwurf: hyperframes render --quality draft, um ein Vielfaches schneller als das Finale. Damit wird alles überprüft, das Finale wird einmal gerendert.
  • Normales Video (MP4, H.264): Hook, Finale und alles, was im Vollbild steht. Alpha macht die Datei hier nur schwerer.
  • Transparenter Hintergrund für den Schnitt: Einblendungen, Kapitel über Footage, Zahlen. HyperFrames rendert selbst MOV ProRes 4444 mit Alpha (--format mov) für DaVinci Resolve, Premiere und Final Cut, für das Web gibt es WebM mit Alpha (--format webm). MP4 speichert kein Alpha. Vollbild-Grafik für den Schnitt kann mit ffmpeg in ProRes 422 HQ konvertiert werden, sie ist leichter.
  • Gegen Streifen bei Verläufen: leichtes Rauschen (texture.grain) und ProRes-Master.
  • Keine Frame-Erfassung in PNG (--video-frame-format png): In der Studio-Prüfung hat dies dunkle Bereiche ins Schwarze getrieben.
  • Dateinamen in lateinischen Buchstaben nach Szenen: name-01-sokolova.mov.

Entwurf über Footage vor dem Finale

Auf schwarzem Hintergrund sieht alles normal aus. Probleme werden erst auf dem echten Bild sichtbar: Eine Einblendung verdeckt das Gesicht, weißer Text verschwindet im Fenster.

  1. Rendere die Szenen in Entwurfsqualität mit transparentem Hintergrund.
  2. ffmpeg legt sie über Frames oder Teile des echten Videos (preview_bg im Briefing: eine Datei, ein Video oder ein Ordner mit Frames, werden den Szenen im Kreis zugewiesen) und verbindet sie zu einer Vorschau.
  3. Frame-Liste: Anfang, Mitte und Ende jeder Szene in einem Bild.
  4. Sichtprüfung und Vorlage beim Eigentümer mit einer nummerierten Liste der Szenen, damit die Antwort ein Wort ist. Ein bestandener Lint bedeutet nicht, dass das Design funktioniert.

Prüfungen

  • hyperframes lint nach jeder neuen Vorlage, vor der Anzeige hyperframes check (lint, Browser-Fehler, Layout und Textkontrast in einem Durchlauf), hyperframes doctor, wenn das Rendern fehlschlägt. Lint fängt echte Bugs: Eine Vollbildschicht ohne Null-Transparenz zu Beginn hellt die ersten Frames auf; Zentrierung durch translate(-50%,-50%) zusammen mit einem Tween auf y verrutscht am Ende, zentriere mit einem Flex-Wrapper.
  • Suche nach schwarzen Frames im Entwurf und Finale: ffmpeg misst die Helligkeit der Frames, ein vollständig schwarzer Frame an der Nahtstelle bedeutet eine fehlende Szene oder ein eingefrorenes Video. Jedes Video in einer Komposition muss eine eigene id haben, sonst friert der Frame ein.
  • Vergleich des Finales mit dem Entwurf auf dunkle Frames: Der Anteil der in Schwarz gefallenen Pixel sollte nicht zunehmen.

Arbeitsablauf

  1. Marke: Gibt es brand.json? Nein, erstelle und prüfe mit dem Skript.
  2. Plan: Nummerierte Liste der Szenen mit Rollen, Texten, Format und Dauer. Zeige den Plan, nicht das Video:
Marke: Fjord Lab, 16:9, Alpha für Einblendungen

01. name / bl / alpha: „Maria Sokolova“ · „Tontechnikerin“, 4 s
02. chapter / alpha: „Kapitel 2“ · „Wie wir Stille schreiben“, 3 s
03. number / right / alpha: 48 Stunden · „für die Aufnahme einer Episode“, 3.5 s
04. endcard / MP4: „Fjord Lab“ · fjordlab.example, 5 s
  1. Briefing scenes.json nach genehmigtem Plan.
  2. Kompositionen nach Rollen, hyperframes lint.
  3. Entwurf über Footage, Frame-Liste, Suche nach schwarzen Frames, Präsentation.
  4. Änderungen in Worten („dritte kürzer“, „Name größer“) werden im Briefing korrigiert, allgemeine („alle Einblendungen langsamer“) in der Marke.
  5. Finales Rendern, ProRes 4444 für transparente Szenen, Abgleich mit dem Entwurf, Ausgabe der Dateien in einen Ordner für den Schnitt.

Typische Fehler

  • Farbe oder Geschwindigkeit direkt in der Szene. Nach fünf Videos gibt es fünf verschiedene Akzente im Projekt. Alles Visuelle nur in der Marke.
  • Bewertung von Grafik auf flachem Hintergrund. Eine Einblendung „sieht toll aus“ bis …

...

[abgeschnitten zur Übersetzung]

Individual skills in this repo

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

shutckin/aivfx-content-kit

Runs a client AI video for a concept studio from brief to delivery. Takes the brief and real product photos, writes a synopsis, builds character and location sheets with 3 options each, a 16:9 approval deck, stills in waves, one prompt for the whole video, client revisions as a list, assembly and a delivery checklist. Core rule: the client approves the preproduction package before the first video frame, and the approved character and location sheets go as references into every generation. Use when a brief arrives for an advertising or product AI video. Triggers: 'client AI video', 'preproduction package', 'character sheet', 'location sheet'. Not for articles or covers (use blog-article and article-cover). Triggers (RU): «вот бриф», «новый клиент», «концепт студия», «препродакшн-пакет», «лист персонажа», «лист локации», «презентация клиенту», «правки от клиента», «готовим сдачу».

shutckin/aivfx-content-kit

Packages YouTube videos and Shorts: a pack of 3-4 thumbnail variants of one idea for choice and A/B testing, title and thumbnail as one unit, one idea per image, face and emotion, a large object, text up to 3-4 words or none, readable on a small phone screen. Works from own frames and screenshots plus references, generates or refines the frame with models (Nano Banana, Seedream, GPT-Image, Higgsfield and others) with the film-look style and logos in one pass, keeps a consistent channel series, checks the file with a script (size, weight, name), reviews the small view by eye on a contact sheet and shows options to the owner before upload. Triggers: 'YouTube thumbnail', 'video packaging', 'thumbnail A/B test', 'Shorts cover', 'title and thumbnail'. Triggers (RU): «сделай превью», «обложку для ролика», «обложку для YouTube», «упакуй ролик», «варианты для A/B-теста», «заголовок и превью», «обложку для Shorts», «серия превью для канала».

Verwandte Skills