Plugin-Installationen: Befolgen Sie vor Setup- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln, wenn dieser Skill innerhalb eines HyperFrames-Plugins verwendet wird. Bei eigenständigen Installationen gelten die untenstehenden Aktualisierungshinweise.
Halten Sie diesen Skill zunächst aktuell – bestätigen Sie mit dem Benutzer, bevor Sie Folgendes ausführen:
npx hyperframes skills update motion-graphics. Ein schneller No-Op, wenn alles auf dem neuesten Stand ist; andernfalls wird dieser Skill zusammen mit den von ihm abhängigen Kern-Domain-Skills aktualisiert, bevor Sie darauf zurückgreifen.
figma-Quelle: Wenn das Logo/Asset/die Animation, die erstellt werden soll, von einer figma.com-URL stammt, führen Sie zuerst
/figmaaus – Asset-Export, Marken-Token und Motion→GSAP-Übersetzung, wenn die Grafik ein Figma Motion-Import ist – und bauen Sie dann auf dessen Ausgabe auf. Steuern Sie Figma nicht direkt über rohe MCP-Tools: Das überspringt die SVG-Bereinigung, die.media/manifest.jsonl-Herkunft und dievar()-Bindung der Marken-Token, sodass eine spätere Markenänderung ohne einen vollständigen Neuimport nicht propagiert werden kann.
motion-graphics — Dispatch-Einstieg
Die Eingangstür ist
/hyperframes. Dieser Skill erstellt eine kurze, designorientierte, unkommentierte Bewegtgrafik (Bewegung ist die Botschaft; ~unter 10s, ohne Voice-Over). Alles, was länger ist, eine Erzählung enthält oder mehrere Szenen umfasst – oder bei Unsicherheit → lesen Sie zuerst/hyperframes: Die Intentionsebene entscheidet über jede Routenwahl.
Dieser Workflow ist von Natur aus autonom – maximal eine klärende Frage (agents/director.md), dann Aufbau bis zur Überprüfung ohne Zwischenkontrolle. Die Intentionsebene (/hyperframes → references/intent-interview.md) leitet hier direkt ohne Run-Shape-Fragen weiter; ein Storyboard und eine begleitende Sitzung bringen bei einem so kurzen Stück wenig. Das Rendern erfolgt dennoch benutzergesteuert: Nach bestandenen Prüfungen und Proof-Snapshots öffnen Sie die Studio-Vorschau und stellen die kanonische Frage „jetzt rendern oder was ändern?“ aus ../hyperframes/references/brief-contract.md. Wenn eine BRIEF.md existiert, lesen Sie diese vor der Regiefrage.
Eine kurze, designorientierte Bewegtgrafik. Asset-zuerst: Entscheiden Sie die Asset-Strategie und beschaffen Sie echtes Material, bevor Sie die Einstellung entwerfen, entwerfen Sie dann die Einstellung um das Vorhandene herum und komponieren Sie schließlich durch Wiederverwendung von Katalogfunktionen. Alle Artefakte gehen nach PROJECT_DIR = videos/<project-name>/ (erstellt in Schritt 0); alle nachfolgenden Pfade sind relativ dazu.
| Phase | Ausführung | Primäres Artefakt | Detaillierter Ablauf |
|---|---|---|---|
| init | Bash | hyperframes.json | Schritt 0 |
| plan | Subagent – Entscheidung: Suche? + Klassifizierung + Asset-Strategie | shot-plan.json (Entwurf: Kategorie, asset_needs-Abfragen, Kurzbeschreibung) | agents/director.md (Teil 1) |
| source ◇ | Bash – Mediennutzungs-Auflösung (überspringen, wenn asset_needs leer ist) | assets/ + assets/index.md | phases/source/guide.md |
| design | Subagent – Einstellungsdesign um aufgelöste Assets herum | shot-plan.json (final: Block(s) + Layout + Bewegung + Positionen) | agents/director.md (Teil 2) |
| build | Subagent – Wiederverwendungsorientierte Komposition | compositions/index.html | agents/builder.md |
| verify | Bash – lint, check, Proof-Snapshots; Reparatur bei Fehlschlag | snapshots/contact-sheet.jpg | Schritt 5 |
| approve | Vorschau öffnen; nach Rendern oder Änderungen fragen; auf Antwort warten | explizite Rendergenehmigung | Schritt 6 |
| render | Bash – hyperframes render (MP4 oder --format webm/mov für Überlagerung) | renders/video.mp4 oder transparente Überlagerung | Schritt 6 |
◇ source wird nur ausgeführt, wenn die gewählte Kategorie Assets deklariert. Reine Code/Text-Kategorien (z.B. kinetic-type, die meisten charts/stat) haben asset_needs: [] und springen direkt von der Planung zum Design.
Kategorien – aufgeteilt nach der Suchentscheidung
Die erste Entscheidung von plan ist: Ist eine Suche erforderlich? Diese Gabelung teilt die Kategorien in zwei Gruppen; dann wird die spezifische Kategorie ausgewählt – bei suchgesteuerten Kategorien nach der Art des Inhalts, den die Suche zurückgibt. Jede Kategorie ist ein categories/<id>/module.md (seine Planungs- und Bauregeln); das gemeinsame Bewegungsvokabular lebt in references/motion-vocabulary.md (→ hyperframes-animation-Regeln/Blueprint + Registry-Blöcke).
Formularkategorien – keine Suche; der Benutzer liefert den Inhalt:
| Kategorie | Absicht | Stützt sich auf |
|---|---|---|
kinetic-type | prägnante Zeile / Zitat / Titel, bewegungsorientierter Text | caption-*-Blöcke + Animationsregeln |
stat | einzelne Heldenzahl / Count-Up + Ring | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | Balken / Linie / Kreis / Rennen / % aus Daten | data-chart-Block |
logo-reveal | Logo-Sting / Brand-Lockup (Benutzer-Logo) | logo-outro / rules/svg-path-draw |
lower-thirds | Namens-/Titelbalken, Callouts, Social-Overlays | caption-* + Registry-Overlay-Blöcke |
maps | geografische Bewegung – Regionen hervorheben, Orte verbinden, zu einem Ort zoomen (Vektorspur oder gebackene Basemap-Spur) | us-map / world-map-Familie + bake-basemap.mjs |
Suchgesteuerte Kategorien – zuerst Suche, dann Animation nach Inhaltstyp (der RWA-Pfad):
| Zurückgegebener Inhalt | Kategorie | Animation |
|---|---|---|
| Webseite / Link | webpage | Webseiten-/UI-Animation (Scrollen, Einblenden, Cursor, Callouts) |
| Nachrichtenartikel | news | Schlagzeilen-Einblendung + Quellenkarte + Key-Fact-Callouts |
| Tweet | tweet | Animierte Tweet-Karte |
| Bild / Entität | asset-fusion | Die Geometrie des Assets wird zum Diagramm (RWA diegetische Fusion) |
Build-Reihenfolge: einzeln, abdeckungsorientiert (grob ist in Ordnung). kinetic-type aus dem Prototyp portiert; der Rest folgt.
Voraussetzungen
macOS Apple Silicon oder Linux x64. Systemtools: brew install node ffmpeg. Einmalig npx hyperframes doctor. macOS GPU-Render: export PRODUCER_BROWSER_GPU_MODE=hardware.
Optionale Schlüssel (lokale Fallbacks, falls nicht gesetzt) – werden nur von Kategorien benötigt, die Assets über Mediennutzung beziehen/generieren:
| Schlüssel | Verwendet für | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | Bildgenerierung (Mediennutzungs-Auflösung) | Generate überspringen / nur Suche |
| (asset_scout / Suchanbieter) | webpage/news/tweet + asset-fusion-Echt-Asset-Suche | Kategorie degradiert zu asset-frei |
Ablauf
Schritt 0 – Initialisierung
Das aktuelle Arbeitsverzeichnis ist das Agenten-Workspace-Root; schreiben Sie alle Artefakte unter PROJECT_DIR = videos/<project-name>/. <project-name>: Verwenden Sie das vom Benutzer angegebene Verzeichnis, andernfalls einen kurzen Kebab-Case-Namen aus der Absicht (<subject>-motion). Nicht den Workspace-Basename oder einen Zeitstempel.
Nur wenn $PROJECT_DIR/hyperframes.json fehlt:
PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics
init überprüft die installierten Skills mit den neuesten auf GitHub und aktualisiert das globale Set, wenn welche veraltet sind.
Einschränkungen: Führen Sie niemals hyperframes init im Workspace-Root aus; verschachteln Sie niemals ein weiteres hyperframes/ innerhalb von PROJECT_DIR; jeder Bash-Befehl (Master + Subagents) ist eine (cd "$PROJECT_DIR" && ...)-Subshell – niemals ein bloßes cd.
Schritt 1 – Planen (Subagent: Director Teil 1)
Starten Sie einen Subagenten. Prompt = vollständiges agents/director.md + ## Dispatch-Kontext (SKILL_DIR / PROJECT_DIR / die Anfrage des Benutzers / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Er muss:
- Entscheiden: Ist eine Suche erforderlich? (die erste Gabelung)
- Nein → wählen Sie eine Formkategorie (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps); der Inhalt wird vom Benutzer bereitgestellt;
asset_needs: []. - Ja → geben Sie einen Suchplan in
asset_needs[]aus (news / web / tweet / image; zweipolige Abfragen). Die spezifische suchgesteuerte Kategorie (webpage / news / tweet / asset-fusion) wird durch den in Schritt 2 zurückgegebenen Inhaltstyp bestätigt und in Schritt 3 finalisiert.
- Nein → wählen Sie eine Formkategorie (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps); der Inhalt wird vom Benutzer bereitgestellt;
- Schreiben Sie einen Entwurf
shot-plan.json(Hülle + gewählte Formkategorie oder Suchabsicht +asset_needs+ eine ein Absatz lange Kurzbeschreibung der Einstellung). Schema:references/shot-plan-ir.md.
Validierung: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.
Schritt 2 – Beschaffen ◇ (Bash: Mediennutzung, bedingt)
Wenn shot-plan.json.asset_needs nicht leer ist, lösen Sie Assets auf (Suche / Generierung / Abruf → eingefrorene projektspezifische Pfade + Journal). Siehe phases/source/guide.md (umfasst media-use resolve; die suchgesteuerten Kategorien verwenden die Nachrichten-/Web-/Tweet-/Bildersuche). Wenn asset_needs leer ist, überspringen Sie zu Schritt 3.
Graceful Degradation: Wenn ein Such-/Anbieter nicht verfügbar ist, fällt die Kategorie auf asset-frei zurück (vermerken Sie dies in context.log).
Schritt 3 – Entwerfen (Subagent: Director Teil 2)
Starten Sie einen Subagenten (Prompt = agents/director.md Teil 2 + Dispatch-Kontext einschließlich des aufgelösten assets/index.md, falls Schritt 2 ausgeführt wurde + catalog-map.md). Er entwirft die Einstellung um die verfügbaren Assets herum: wählt die Katalogblöcke + die hyperframes-animation-Regeln/Blueprints, das Layout, die Bewegung, die Beats und (für asset-fusion) die element_positions + die Pipettenpalette. Finalisiert shot-plan.json (content.block + content.customize + pro-Kategorie-Inhalt).
Schritt 4 – Bauen (Subagent: Builder, Wiederverwendung zuerst)
Fügen Sie die gemeinsamen Bewegungsprinzipien in den Dispatch-Kontext des Builders ein. Fügen Sie für charts und stat auch Daten in Bewegung hinzu. Der Builder liest diese Anleitungen, bevor er die Timeline schreibt.
Starten Sie einen Subagenten. Prompt = vollständiges agents/builder.md + Dispatch-Kontext (shot-plan.json, catalog-map.md, das module.md der Kategorie, references/motion-vocabulary.md, references/builder-contract.md). Wiederverwendung zuerst: npx hyperframes add <block> + Anpassung vor Ort; nur Lücken + die Asset-Fusion-Möglichkeit von Hand erstellen. Ausgabe: compositions/index.html unter Einhaltung des HF-Vertrags (pausierte GSAP-Timeline auf window.__timelines, class="clip" + stabile IDs, tl.seek(0), deterministisch).
Schritt 5 – Überprüfen (Bash → Reparatursubagent bei Fehlschlag)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-zeitpunkte>)
Wählen Sie Proof-Zeitpunkte, die den Anfangszustand, die charakteristische Bewegung und den finalen Haltepunkt zeigen. Überprüfen Sie das generierte Kontakt- oder Snapshot-Blatt, bevor Sie fortfahren. Bei Fehlschlag von lint, check oder Snapshot starten Sie den Reparatursubagenten (agents/finalize.md) für einen einmaligen Korrekturprozess vor Ort und führen dann das fehlgeschlagene Gate erneut aus. Ändern Sie niemals eine festgelegte Dauer, nur um einen Fehler zu verbergen.
Schritt 6 – Genehmigen und rendern (Bash)
Öffnen Sie Studio und stellen Sie dann eine Frage: „Jetzt rendern oder was ändern?“ Kehren Sie nach Überarbeitungen zum selben Gate zurück:
(cd "$PROJECT_DIR" && npx hyperframes preview --background)
Rendern Sie erst nach einer expliziten Render-Antwort:
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# transparente Überlagerungsvariante: --format webm (oder mov)
Überprüfen Sie, ob die Ausgabe existiert, nicht leer ist und die beabsichtigte Dauer hat. Die endgültige Übergabe benennt das Artefakt, die tatsächliche Dauer, die Kompositions- oder Frame-ID, die Proof-Zeitpunkte und das überprüfte Kontakt- oder Snapshot-Blatt. Flags leben in /hyperframes-cli → references/preview-render.md.
Fortsetzungstabelle
| Zustand | Fortsetzen ab |
|---|---|
kein shot-plan.json | Schritt 1 (planen) |
shot-plan.json hat asset_needs, kein assets/ | Schritt 2 (beschaffen) |
shot-plan.json final, kein compositions/index.html | Schritt 3/4 (entwerfen+bauen) |
compositions/index.html existiert, Proof-Snapshots fehlen | Schritt 5 (überprüfen) |
| Prüfungen und Proof-Snapshots bestanden, kein genehmigtes Rendern | Schritt 6 (Genehmigung) |
| Genehmigtes Rendern existiert | Ausgabe überprüfen, dann melden |
Design-Notizen (Maintainer – Ausführung liest dies nicht)
- Asset-zuerst-Ration
…
[gekürzt zur Übersetzung]