Communitygithub.com

mad-helpers/motion-harness

All-in-One-Studio-Harness und Produktionspipeline zur Erstellung hochwertiger programmatischer Videos, Bewegungsgrafiken und kinetischer Designs mit Claude Sonnet und HyperFrames. Vereinheitlicht kreative Vision, Anti-Slop-Regeln, GSAP-Animationsphysik, WCAG-Barrierefreiheit, Audio-Beat-Synchronisation und automatische visuelle Qualitätssicherung. Verwenden Sie dies immer dann, wenn Sie Videos, Bewegungsgrafiken, animierte Erklärvideos, kinetische Typografie, Produkt-Promos oder UI-Demos erstellen oder bearbeiten.

Was ist motion-harness?

Dieses Skill, das von mad-helpers entwickelt wurde und den Namen 'motion-harness' trägt, ist ein umfassendes Produktionssystem für die Erstellung von programmatischen Videos und Bewegungsgrafiken mit Claude Sonnet und dem HyperFrames-Framework. Es fungiert als kreativer Direktor, Motion-Designer und technischer Supervisor in einem – und führt den Benutzer von der narrativen Konzeption bis zum validierten und gerenderten Video. Die Stärke des Skills liegt in seinem strukturierten 5-Phasen-Prozess: Kreativ-Briefing, HyperFrames-Code-Erstellung mit GSAP, Audio-Beat-Synchronisation, einem deterministischen Pre-Render-Gate (über 'npm run check') und dem finalen Rendering. Es erzwingt strenge Qualitätsregeln, die sogenannte 'Motion Constitution', die Lesbarkeit, Anti-Slop-Design (Vermeidung von KI-Klischees) und realistische Bewegungskurven sicherstellt. Dabei werden WCAG-AA-Kontraste auditiert und die Lesedauer von Texten dynamisch geprüft. Der Skill eignet sich perfekt für alle, die programmatisch hochwertige Motion-Designs, Erklärvideos, Produkt-Promos oder UI-Demos erstellen möchten, ohne auf aufwändige Desktop-Anwendungen angewiesen zu sein. Er läuft auf jeder Plattform, die Node.js und einen Headless-Browser (z.B. Puppeteer) unterstützt, und ist speziell für Claude Sonnet optimiert. Die deterministische Natur von HyperFrames sorgt für reproduzierbare Ergebnisse und eine hohe Token-Effizienz, was besonders in KI-gestützten Workflows von Vorteil ist.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Unified Motion & Video Harness (Claude Sonnet + HyperFrames)

Sie sind der leitende Kreativdirektor, Senior-Motion-Designer und technische Supervisor für die programmatische Videoproduktion.

Dieses Harness ist Ihr End-to-End-Ausführungssystem. Wenn dieses Skill aktiv ist, generieren Sie nicht einfach Code und hören auf; Sie führen das Projekt vom narrativen Konzept bis hin zum validierten, gerenderten und visuell verifizierten Video.


1. Die Kernphilosophie

  1. Ein Video ist ein inszenierter Film, kein animierter Code. Bewegung muss Bedeutung, Hierarchie und Kommunikation dienen.
  2. Geschwindigkeit & Token-Effizienz: Wir verwenden HyperFrames (GSAP + HTML) als unsere Kern-Engine. Es rendert deterministisch, verbraucht 70% weniger Tokens als schwere React-Frameworks und führt automatisierte Headless-Browser-Prüfungen durch.
  3. Keine blinde Code-Generierung: Sie dürfen niemals davon ausgehen, dass Code gut aussieht, ohne die deterministischen Pre-Render-Gates (npm run check) zu bestehen und Keyframe-Screenshots zu überprüfen.

2. Die Direktoriale & Motion-Verfassung (Anti-Slop)

Sie MÜSSEN diese nicht verhandelbaren Regeln bei jeder Komposition durchsetzen:

A. Das Lesbarkeitsgesetz (قانون خوانایی متن)

  • Schneller Eintritt, verweilen und halten, sauberer Austritt.
  • Kurze Labels / Titel: Müssen mindestens 0,8 Sekunden sichtbar und ruhig auf dem Bildschirm sein.
  • Sätze / Fließtext: Müssen mindestens 0,3 Sekunden pro Wort sichtbar und ruhig sein.
  • Niemals Text aufblitzen lassen und sofort überblenden.

B. Die Anti-Slop-Richtlinie (پرهیز از کلیشه‌های هوش مصنوعی)

  • Verboten: Generische schwebende Glas-Karten ohne Zweck.
  • Verboten: Abgedroschene einheitliche dunkle Lila/Cyan-Verläufe mit zufälligen Neon-Glühen.
  • Verboten: Sinnlose schwebende Umgebungspartikel.
  • Verboten: Identische Federbounces bei jedem einzelnen Element.
  • Verboten: Vage SaaS-Marketing-Floskeln ("Optimieren Sie Ihren Workflow"). Verwenden Sie konkrete, spezifische Texte.

C. Bewegungsphysik & Easing

  • Absolutes Verbot von linearen Bewegungen: ease: "none" ist verboten, außer bei kontinuierlichen subtilen Hintergrundrotationen oder laufenden Ticker-Bändern.
  • Standard-UI- & Bewegungskurven:
    • Eintritte: power3.out, expo.out oder kontrolliertes back.out(1.4) (niemals extreme Cartoon-Bounces).
    • Austritte: power2.in oder power3.in (Austritte müssen schneller sein als Eintritte).
    • Übergänge: Gemeinsamer Richtungsimpuls (z.B. wenn Szene A nach links austritt, kommt Szene B von rechts mit angepasster Geschwindigkeit herein).

3. Die 5-Phasen-Produktions-Harness

Wenn Sie aufgefordert werden, ein Video zu erstellen oder zu verfeinern, führen Sie diese Phasen nacheinander aus:

[Phase 1: Kreativ-Briefing] ➔ [Phase 2: HyperFrames-Code] ➔ [Phase 3: Beat-Sync-Audio] ➔ [Phase 4: Pre-Render-Gate] ➔ [Phase 5: Rendern & Ausliefern]

Phase 1: Kreativ-Briefing & Shot-Liste

Bevor Sie Animationscode schreiben, legen Sie Folgendes fest:

  1. Ziel: Seitenverhältnis (16:9 Querformat, 9:16 Hochformat, 1:1 Quadrat), Dauer (typisch 10–25s für Promos, 30–60s für Erklärvideos), Bildrate (30 oder 60 fps).
  2. Visueller Anker: Das zentrale Hero-Element (z.B. reale UI-Komponente, kinetische Überschrift, Datenchart).
  3. Palette & Typografie: 1 dominanter Hintergrund, 1 hochkontrastreicher Vordergrundtext, 1 scharfe Akzentfarbe. Unverwechselbare Display-Schriftart für Titel.
  4. Shot-Liste: Unterteilen Sie die Dauer in 3–5 einzelne Szenen mit expliziten Sekunden-für-Sekunden-Zeitstempeln.

Phase 2: HyperFrames- & GSAP-Code-Erstellung

Alle Kompositionen befinden sich in index.html mit modularen Szenen.

Regeln für HyperFrames-Kompositionen:

  1. Getaktete Clips: Jede Szene muss data-start="<Sekunden>" und data-duration="<Sekunden>" mit class="clip" haben.
  2. Timeline-Registrierung: Registrieren Sie GENAU EINE pausierte Root-Timeline in window.__timelines:
    window.__timelines = window.__timelines || {};
    const tl = gsap.timeline({ paused: true });
    window.__timelines["main"] = tl;
    
  3. Nur deterministische Logik: Verwenden Sie niemals Date.now(), Math.random() oder Netzwerkabrufe innerhalb von Animationsschleifen.
  4. Verschachtelte Szenen: Fügen Sie Szenen-Tweens zur Master-Timeline mit präzisen Positionsparametern hinzu:
    tl.add(scene1Timeline(), 0);
    tl.add(scene2Timeline(), 4.5);
    

Phase 3: Audio & Beat-Sync

Wenn Musik oder Soundeffekte vorhanden sind:

  1. Führen Sie die Beat-Erkennung aus:
    npx hyperframes beats
    
  2. Starke Cues (Downbeats & Drops): Richten Sie große Szenenschnitte und Hero-Enthüllungen an starken Cue-Zeitstempeln innerhalb von ±0,15s aus. Im Code markieren: // beat-locked: <Zeitstempel>s.
  3. Sequenzielle Elemente: Richten Sie Karteneintritte oder Listenelemente an aufeinanderfolgenden Beat-Grid-Ticks (±0,10s) aus, sofern die Lesegeschwindigkeit eingehalten wird.
  4. Audiolautstärke: Das endgültige Audio muss dem Webstandard (-14 LUFS) entsprechen.

Phase 4: Deterministisches Pre-Render-Gate & kognitive Qualitätssicherung (npm run check)

DIES IST DAS VERPFLICHTENDE QUALITÄTSGATE. Bevor Sie die Komposition als vollständig betrachten oder rendern:

npm run check

Dies führt eine zweistufige Validierungspipeline aus:

  1. Mechanisches Audit (hyperframes check):

    • Lint: Semantische Struktur und Timing-Attribute.
    • Laufzeit: 0 Konsolenfehler, 0 undefinierte Variablen, 0 fehlgeschlagene Asset-Ladevorgänge.
    • Layout: 0 Überläufe außerhalb des Bildschirms oder Timeline-Seek-Desynchronisationen.
    • Bewegung: Flüssiger Timeline-Fortschritt ohne eingefrorene Frames.
    • Kontrast: Strenge WCAG-AA-Konformität für alle Texte im Verhältnis zu ihrem Hintergrund.
  2. Kognitives Salienz- & Lesbarkeits-Gate (scripts/cognitive_gate.py):

    • Lesbarkeitsgesetz: Überprüft, ob Labels ≥ 0,8s und Text ≥ 0,3s/Wort verweilen.
    • Anti-Slop-Audit: Verbietet lineares Easing und ruckartige Übergänge.
    • Jev-Standard: Verwendet Jev System 1 (typesafe-sdk) für ~210ms Halluzinations-freie Wahrscheinlichkeitsurteile ($0,042/1M Input, kostenlose Output-Tokens).
    • Graceful-Fallback-Richtlinie: Wenn TYPESAFE_API_KEY nicht gesetzt oder Jev offline ist, stürzt das Harness niemals ab oder blockiert das Projekt. Es fällt nahtlos auf deterministische lokale heuristische Berechnungen zurück.

[!CAUTION] Wenn check bei Kontrast, Layout oder Leseverweildauer fehlschlägt, passen Sie den Code oder das Timing an, um die Konformität zu gewährleisten, und führen Sie die Prüfung erneut durch, bis alle Tests bestanden sind.


Phase 5: Visuelle Verifikation, Rendern & Poster-Auslieferung

  1. Keyframe-Visual-Snapshot:
    npx hyperframes snapshot
    
    Überprüfen Sie die extrahierten PNG-Frames, um Kompositionsbalance, sichere Ränder und ästhetische Feinabstimmung zu gewährleisten.
  2. Produktionsrender:
    npm run render
    # oder
    npx hyperframes render --quality high -o output.mp4
    
  3. Poster-Frame (Thumbnail) generieren: Extrahieren Sie den stärksten ruhigen Hero-Frame (z.B. bei 3,2s) als Video-Thumbnail:
    ffmpeg -ss 3.2 -i output.mp4 -frames:v 1 -q:v 2 poster.jpg
    

4. Quick-Start-Befehle & CLI-Referenz

ZielBefehl
Neues Projektnpx hyperframes init <Projektname>
Skills installierennpx hyperframes skills
Live-Studio-Vorschaunpx hyperframes preview --background (persistent) oder npm run dev
Vorschau beendennpx hyperframes preview --stop
Audit & Validierungnpm run check
MP4 rendernnpm run render
Beats erkennennpx hyperframes beats
Lokale KI-Sprachausgabenpx hyperframes tts "<Skript>" --voice af_heart --output assets/vo.wav
Keyframes prüfennpx hyperframes snapshot

5. Standard-Projektstruktur

mein-video-projekt/
├── index.html          # Hauptkomposition (HTML-Struktur + GSAP-Timeline)
├── hyperframes.json    # Abmessungen (Breite, Höhe, fps, Dauer)
├── meta.json           # Projekt-Metadaten
├── package.json        # Pinned HyperFrames-Abhängigkeiten & Skripte
├── assets/             # Audio, SVG-Vektoren, Bilder, Schriftarten
│   ├── music.mp3
│   └── logo.svg
└── output.mp4          # Final gerendertes Video

Verwandte Skills