Plugin-Installationen: Bevor Sie Setup- oder Aktualisierungsbefehle ausführen, befolgen Sie die Plugin-Ausführungsregeln, wenn sich dieser Skill innerhalb eines HyperFrames-Plugins befindet. Bei Standalone-Installationen gelten die untenstehenden Update-Anweisungen.
Erstens, diesen Skill aktuell halten – vor Ausführung mit dem Benutzer bestätigen:
npx hyperframes skills update motion-graphics. Ein schneller No-Op, wenn alles aktuell ist; andernfalls wird dieser Skill sowie die abhängigen Kern-Domain-Skills aktualisiert, bevor Sie sie verwenden.
figma-Quelle: Wenn das Logo/Asset/die Animation zum Erstellen von einer figma.com-URL stammt, führen Sie zuerst
/figmaaus – Asset-Export, Brand-Tokens und Motion→GSAP-Übersetzung, wenn die Grafik ein Figma-Motion-Import ist – und bauen Sie dann auf der Ausgabe auf. Steuern Sie Figma nicht direkt über rohe MCP-Werkzeuge: das umgeht die SVG-Bereinigung, die.media/manifest.jsonl-Herkunft und die Brand-Token-var()-Bindung, sodass eine spätere Markenänderung nicht ohne vollständigen Neuimport weitergegeben werden kann.
motion-graphics — Dispatch-Eintritt
Die Eingangstür ist
/hyperframes. Dieser Skill erstellt eine kurze, designorientierte, unerzählte Bewegtgrafik (Bewegung ist die Botschaft; ~unter 10s, kein Voice-Over). Alles Längere, Erzählte oder Mehr-Szenerische – oder bei Unklarheit → zuerst/hyperframeslesen: die Intent-Ebene besitzt jede Routenentscheidung.
Dieser Workflow ist von Natur aus autonom – höchstens eine klärende Frage (agents/director.md), dann Aufbau durch Verifikation ohne Zwischenprüfung. Die Intent-Ebene (/hyperframes → references/intent-interview.md) leitet direkt hierher weiter, ohne Laufzeit-Formfragen; ein Storyboard und eine Begleitsitzung bringen bei einem so kurzen Stück wenig. Das Rendering bleibt benutzergesteuert: nach bestandenen Checks 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 sie vor der Director-Frage.
Eine kurze designorientierte Bewegtgrafik. Asset-zuerst: Entscheiden Sie die Asset-Strategie und beschaffen Sie echtes Material, bevor Sie den Shot entwerfen, entwerfen Sie dann den Shot um das Vorhandene herum und komponieren Sie durch Wiederverwendung von Katalog-Fähigkeiten. Alle Artefakte gehen nach PROJECT_DIR = videos/<projekt-name>/ (erstellt in Schritt 0); alle Pfade unten sind relativ dazu.
| Phase | Ausführung | Primäres Artefakt | Detaillierter Ablauf |
|---|---|---|---|
| init | Bash | hyperframes.json | Schritt 0 |
| plan | Subagent — Suche entscheiden? + Klassifizieren + Asset-Strategie | shot-plan.json (Entwurf: Kategorie, asset_needs-Abfragen, Brief) | agents/director.md (Teil 1) |
| source ◇ | Bash — Medien-Nutzung auflösen (überspringen, wenn asset_needs leer ist) | assets/ + assets/index.md | phases/source/guide.md |
| design | Subagent — Shot-Design um aufgelöste Assets herum | shot-plan.json (final: Block(s) + Layout + Bewegung + Positionen) | agents/director.md (Teil 2) |
| build | Subagent — Wiederverwendungs-erste 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; Rendern oder Änderungen fragen; auf Antwort warten | explizite Rendergenehmigung | Schritt 6 |
| render | Bash — hyperframes render (MP4, oder --format webm/mov für Overlay) | renders/video.mp4 oder transparentes Overlay | Schritt 6 |
◇ source läuft nur, wenn die gewählte Kategorie Assets deklariert. Reine Code/Text-Kategorien (z. B. kinetic-type, die meisten charts/stat) haben asset_needs: [] und überspringen direkt vom Plan zum Design.
Kategorien – aufgeteilt nach der Such-Entscheidung
Die erste Entscheidung von plan ist: braucht dies eine Suche? Diese Gabelung teilt die Kategorien in zwei Gruppen; dann wird die spezifische Kategorie ausgewählt – bei suchgetriebenen nach der Art des zurückgegebenen Inhalts. Jede Kategorie ist ein categories/<id>/module.md (seine Planungs- + Bauregeln); das gemeinsame Bewegungsvokabular lebt in references/motion-vocabulary.md (→ hyperframes-animation Regeln/Blueprint + Registry-Blöcke).
Formkategorien – keine Suche; der Benutzer liefert den Inhalt:
| Kategorie | Absicht | Lehnt sich an |
|---|---|---|
kinetic-type | prägnante Zeile / Zitat / Titel, bewegungs-erster Text | caption-* Blöcke + Animationsregeln |
stat | einzelne Heldenzahl / Zähler + 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-/Titel-Bars, Callouts, Social-Overlays | caption-* + Registry-Overlay-Blöcke |
maps | geografische Bewegung – Regionen hervorheben, Orte verbinden, zu einem Ort zoomen (Vektor-Spur oder gebackene Basemap-Spur) | us-map / world-map Familie + bake-basemap.mjs |
Suchgetriebene Kategorien – zuerst suchen, dann nach Inhaltstyp animieren (der RWA-Pfad):
| Zurückgegebener Inhalt | Kategorie | Animation |
|---|---|---|
| Webseite / Link | webpage | Webseiten-/UI-Animation (Scroll, Reveal, Cursor, Callouts) |
| Nachrichtenartikel | news | Überschriften-Reveal + Quellenkarte + Schlüsselfakt-Callouts |
| Tweet | tweet | animierte Tweet-Karte |
| Bild / Entität | asset-fusion | die Geometrie des Assets wird zum Diagramm (RWA-diegetische Fusion) |
Baureihenfolge: eins nach dem anderen, Abdeckung zuerst (grob ist in Ordnung). kinetic-type aus dem Prototyp portiert; der Rest folgt.
Voraussetzungen
macOS Apple Silicon oder Linux x64. System-Tools: brew install node ffmpeg. npx hyperframes doctor einmal. macOS-GPU-Render: export PRODUCER_BROWSER_GPU_MODE=hardware.
Optionale Schlüssel (lokale Fallbacks, falls nicht gesetzt) – nur benötigt von Kategorien, die Assets über Medien-Nutzung beziehen/generieren:
| Schlüssel | Verwendet für | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | Bildgenerierung (Medien-Nutzung auflösen) | Generierung überspringen / nur Suche |
| (Asset-Scout / Suchanbieter) | webpage/news/tweet + asset-fusion Echt-Asset-Suche | Kategorie degradiert zu Asset-frei |
Ablauf
Schritt 0 — Initialisieren
Das aktuelle Arbeitsverzeichnis (cwd) ist das Agenten-Workspace-Root; schreiben Sie alle Artefakte unter PROJECT_DIR = videos/<projekt-name>/. <projekt-name>: Verwenden Sie das vom Benutzer angegebene Verzeichnis, sonst einen kurzen Kebab-Case-Namen aus der Absicht (<thema>-motion). Nicht den Workspace-Basisnamen oder einen Zeitstempel.
Nur wenn $PROJECT_DIR/hyperframes.json nicht vorhanden ist:
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 auf Aktualität gegenüber GitHub und aktualisiert das globale Set, falls welche veraltet sind.
Einschränkungen: niemals hyperframes init im Workspace-Root; niemals ein weiteres hyperframes/ innerhalb von PROJECT_DIR verschachteln; jeder Bash-Befehl (Master + Subagenten) ist eine (cd "$PROJECT_DIR" && ...) Subshell – niemals bloßes cd.
Schritt 1 — Planen (Subagent: Director Teil 1)
Starten Sie einen Subagenten. Prompt = komplettes agents/director.md + ## Dispatch-Kontext (SKILL_DIR / PROJECT_DIR / die Benutzeranfrage / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Er muss:
- Entscheiden: braucht dies eine Suche? (die erste Gabelung)
- Nein → eine Formkategorie auswählen (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps); der Inhalt wird vom Benutzer bereitgestellt;
asset_needs: []. - Ja → einen Suchplan in
asset_needs[]ausgeben (Nachrichten / Web / Tweet / Bild; zweipolige Abfragen). Die spezifische suchgetriebene Kategorie (webpage / news / tweet / asset-fusion) wird durch den in Schritt 2 zurückgegebenen Inhaltstyp bestätigt und in Schritt 3 finalisiert.
- Nein → eine Formkategorie auswählen (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps); der Inhalt wird vom Benutzer bereitgestellt;
- Einen Entwurf von
shot-plan.jsonschreiben (Hülle + gewählte Formkategorie oder Suchabsicht +asset_needs+ ein einleitender Shot-Brief). Schema:references/shot-plan-ir.md.
Validierung: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.
Schritt 2 — Quellen ◇ (Bash: Medien-Nutzung, bedingt)
Wenn shot-plan.json.asset_needs nicht leer ist, Assets auflösen (Suchen / Generieren / Abrufen → eingefrorene projektspezifische Pfade + Ledger). Siehe phases/source/guide.md (umfasst media-use resolve; die suchgetriebenen Kategorien verwenden die Nachrichten-/Web-/Tweet-/Bildersuche). Wenn asset_needs leer ist, zu Schritt 3 springen.
Anmutig degradieren: Wenn ein Suchanbieter nicht verfügbar ist, fällt die Kategorie auf Asset-frei zurück (Hinweis in context.log).
Schritt 3 — Entwerfen (Subagent: Director Teil 2)
Starten Sie einen Subagenten (Prompt = agents/director.md Teil 2 + Dispatch-Kontext inklusive der aufgelösten assets/index.md, wenn Schritt 2 lief + catalog-map.md). Er entwirft den Shot um die verfügbaren Assets herum: wählt den/die Katalog-Block(s) + die hyperframes-animation Regeln/Blueprints, das Layout, die Bewegung, die Beats und (für asset-fusion) die element_positions + Pipette-Palette. Finalisiert shot-plan.json (content.block + content.customize + Inhalt pro Kategorie).
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 zusätzlich Daten in Bewegung hinzu. Der Builder liest diese Anleitungen vor dem Schreiben der Timeline.
Starten Sie einen Subagenten. Prompt = komplettes 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> + vor Ort anpassen; nur Lücken + die Asset-Fusion-Affordance manuell schreiben. 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 — Verifizieren (Bash → Reparatur-Subagent bei Fehlschlag)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-zeiten>)
Wählen Sie Proof-Zeiten, die den Eröffnungszustand, die charakteristische Bewegung und die finale Halteposition zeigen. Überprüfen Sie das generierte Kontakt- oder Snapshot-Blatt, bevor Sie fortfahren. Bei Fehlschlag von lint, check oder Snapshot starten Sie den Reparatur-Subagenten (agents/finalize.md) für einen einmaligen Korrekturdurchlauf, und führen Sie 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, dann stellen Sie eine Frage: „jetzt rendern, oder was ändern?“ Nach Überarbeitungen kehren Sie zum selben Gate zurück:
(cd "$PROJECT_DIR" && npx hyperframes preview --background)
Rendern Sie nur nach einer expliziten Render-Antwort:
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# transparentes Overlay-Variante: --format webm (oder mov)
Überprüfen Sie, ob die Ausgabe existiert, nicht leer ist und die beabsichtigte Dauer hat. Die finale Übergabe benennt das Artefakt, die tatsächliche Dauer, die Kompositions- oder Frame-ID, die Proof-Zeiten und das geprüfte Kontakt- oder Snapshot-Blatt. Flags leben in /hyperframes-cli → references/preview-render.md.
Fortsetzungstabelle
| Zustand | Fortfahren von |
|---|---|
keine shot-plan.json | Schritt 1 (Plan) |
shot-plan.json hat asset_needs, kein assets/ | Schritt 2 (Quellen) |
shot-plan.json final, kein compositions/index.html | Schritt 3/4 (Entwurf+Bau) |
compositions/index.html existiert, keine Proof-Snapshots | Schritt 5 (Verifizieren) |
| Checks und Proof-Snapshots bestanden, keine genehmigte Render | Schritt 6 (Genehmigung) |
| Genehmigte Render existiert | Ausgabe prüfen, dann melden |
Design-Notizen (Betreuer – die Ausführung liest dies nicht)
- **Asset-zuerst Ration
…