Bewegungsgrafiken — Dispatch-Eintrag
Bestätige die Route vor Schritt 0. Diese Skill erstellt eine kurze, designorientierte, ohne Erzählung auskommende Bewegungsgrafik (Bewegung ist die Botschaft; ~unter 10s, kein Voice-Over). Eine längere, mehrszenige oder erzählte Behandlung →
/general-video; ein erzähltes Video einer Website →/website-to-video; ein Themenerklärer →/faceless-explainer; eine Produkt-Promo →/product-launch-video; Untertitel auf vorhandenem Filmmaterial →/embedded-captions. Außerhalb des Rahmens: Live-/Renderzeitdaten oder Filmmaterial, das es nicht erfassen kann. Unsicher, ob bewegungsorientiert vs. erzählt? Lies zuerst/hyperframes.
Eine kurze designorientierte Bewegungsgrafik. Asset-First: Entscheide die Asset-Strategie und besorge dir echtes Material, bevor du den Shot entwirfst, dann gestalte den Shot um das, was du hast, und setze ihn durch Wiederverwendung von Katalogfähigkeiten zusammen. Alle Artefakte gehen nach PROJECT_DIR = videos/<projektname>/ (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 — Media-Use-Auflösung (überspringen, wenn asset_needs leer ist) | assets/ + assets/index.md | phases/source/guide.md |
| design | Subagent — Shot-Design um aufgelöste Assets | shot-plan.json (final: Block(s) + Layout + Bewegung + Positionen) | agents/director.md (Teil 2) |
| build | Subagent — Wiederverwendungsorientierte Komposition | compositions/index.html | agents/builder.md |
| render | Bash — hyperframes render (MP4, oder --format webm/mov für Overlay) | renders/video.mp4 | Schritt 5 |
| verify | Bash — lint / inspect -> Reparatursubagent bei Fehlschlag | (Fehlerbehebungen direkt) | agents/finalize.md |
◇ 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 von der Planung zum Design.
Kategorien — aufgeteilt nach der Entscheidung zur Suche
Die erste Entscheidung des plan-Schritts ist: Braucht dies eine Suche? Diese Gabelung teilt die Kategorien in zwei Gruppen; dann wird die spezifische Kategorie ausgewählt – bei suchgesteuerten nach der Art des Inhalts, den die Suche zurückgibt. Jede Kategorie ist ein categorien/<id>/module.md (ihre Planungs- + Bauregeln); das gemeinsame Bewegungsvokabular liegt in references/motion-vocabulary.md (→ hyperframes-animation-Regeln/Blaupausen + Registry-Blöcke).
Formkategorien – 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 / Hochzä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 / Marken-Lockup (Benutzerlogo) | logo-outro / rules/svg-path-draw |
lower-thirds | Namens-/Titelbalken, Callouts, Social-Overlays | caption-* + Registry-Overlay-Blöcke |
Suchgesteuerte Kategorien – zuerst suchen, dann nach Inhaltstyp animieren (der RWA-Pfad):
| Zurückgegebener Inhalt | Kategorie | Animation |
|---|---|---|
| Webseite / Link | webpage | Webseiten-/UI-Animation (Scrollen, Enthüllen, Cursor, Callouts) |
| Nachrichtenartikel | news | Schlagzeilen-Enthüllung + Quellenkarte + Schlüsselfakt-Callouts |
| Tweet | tweet | Animierte Tweet-Karte |
| Bild / Entität | asset-fusion | Die Geometrie des Assets wird zum Diagramm (RWA diegetische Fusion) |
Bau-Reihenfolge: eins nach dem anderen, zuerst Abdeckung (grob ist in Ordnung). kinetic-type aus dem Prototypen portiert; der Rest folgt.
Voraussetzungen
macOS Apple Silicon oder Linux x64. System-Tools: brew install node ffmpeg. npx hyperframes doctor einmal ausführen. macOS GPU-Render: export PRODUCER_BROWSER_GPU_MODE=hardware.
Optionale Schlüssel (lokale Fallbacks, falls nicht gesetzt) – nur benötigt von Kategorien, die Assets via Media-Use generieren/beschaffen:
| Schlüssel | Verwendet für | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | Bildgenerierung (Media-Use-Auflösung) | Generierung überspringen / nur suchen |
| (Asset_Scout / Suchanbieter) | webpage/news/tweet + asset-fusion Echt-Asset-Suche | Kategorie degradiert zu asset-frei |
Ablauf
Schritt 0 — Initialisieren
Das aktuelle Arbeitsverzeichnis ist das Agenten-Workspace-Root; schreibe alle Artefakte unter PROJECT_DIR = videos/<projektname>/. <projektname>: Verwende 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 fehlt:
PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<projektname>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank
init überprüft die installierten Skills gegen die neuesten auf GitHub und aktualisiert das globale Set, wenn eine veraltet ist.
Einschränkungen: Niemals hyperframes init im Workspace-Root ausführen; niemals ein weiteres hyperframes/ innerhalb von PROJECT_DIR verschachteln; jeder Bash-Befehl (Master + Subagenten) ist eine (cd "$PROJECT_DIR" && ...)-Subshell – niemals nacktes cd.
Schritt 1 — Planen (Subagent: Director Teil 1)
Starte 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: Braucht dies eine Suche? (die erste Gabelung)
- Nein → wähle eine Formkategorie (kinetic-type / stat / charts / logo-reveal / lower-thirds); Inhalt wird vom Benutzer geliefert;
asset_needs: []. - Ja → gib einen Suchplan in
asset_needs[]aus (Nachrichten / Web / Tweet / Bild; 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ähle eine Formkategorie (kinetic-type / stat / charts / logo-reveal / lower-thirds); Inhalt wird vom Benutzer geliefert;
- Einen Entwurf
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: Media-Use, bedingt)
Wenn shot-plan.json.asset_needs nicht leer ist, Assets auflösen (Suche / Generierung / Abruf → eingefrorene projektspezifische Pfade + Ledger). Siehe phases/source/guide.md (umhüllt media-use resolve; die suchgesteuerten Kategorien verwenden die Nachrichten-/Web-/Tweet-/Bildsuche). Wenn asset_needs leer ist, überspringe zu Schritt 3.
# illustrativ – siehe phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)
Graceful Degradation: Wenn ein Suchanbieter nicht verfügbar ist, fällt die Kategorie auf asset-frei zurück (vermerke es im context.log).
Schritt 3 — Entwerfen (Subagent: Director Teil 2)
Starte einen Subagenten (Prompt = agents/director.md Teil 2 + Dispatch-Kontext inklusive des aufgelösten assets/index.md, wenn Schritt 2 ausgeführt wurde + catalog-map.md). Er entwirft den Shot um die verfügbaren Assets herum: wähle den/die Katalogblock(s) + die hyperframes-animation-Regeln/Blaupausen, das Layout, die Bewegung, die Beats und (für asset-fusion) die element_positions + die Pipettenpalette. Finalisiere shot-plan.json (content.block + content.customize + kategorie-spezifischer Inhalt).
Schritt 4 — Bauen (Subagent: Builder, wiederverwendungsorientiert)
Starte 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). Wiederverwendungsorientiert: 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 — Rendern (Bash)
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# transparente Overlay-Variante: --format webm (oder mov)
Schritt 6 — Verifizieren (Bash → Reparatursubagent bei Fehlschlag)
(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)
exit 0 → fertig. Bei Lint/Inspect-Fehlern den Reparatursubagenten starten (agents/finalize.md: Snapshot-QA + ein In-Place-Fix-Durchlauf + erneutes Rendern). Niemals eine feste Dauer während der Reparatur ändern.
Bericht + optionales Vorschau
Gib das endgültige Ausgabeprodukt (renders/video.mp4, oder die .webm- / .mov-Overlay-Variante) + die Dauer an. Öffne während des Laufs keine Vorschau. Biete sie nur auf Anfrage an, gestartet nach dem Rendern, sodass sie die endgültige Datei bereitstellt:
(cd "$PROJECT_DIR" && npx hyperframes preview) # Studio-UI; oder `npx hyperframes play` für einen teilbaren Link
Flags leben im hyperframes-cli-Skill (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 (sourcen) |
shot-plan.json final, kein compositions/index.html | Schritt 3/4 (entwerfen+bauen) |
compositions/index.html existiert, kein renders/video.mp4 | Schritt 5 (rendern) + Schritt 6 |
renders/video.mp4 existiert | Bericht + Stopp |
Design-Notizen (Betreuer – die Ausführung liest dies nicht)
- Asset-First-Begründung: Das Besorgen wird vorgelagert und informiert das Shot-Design (der RWA-Ablauf: analysieren → suchen → prüfen → komponieren). Die suchgesteuerten Kategorien (
webpage/news/tweet) undasset-fusionstützen sich beide auf die Media-Use-Suche (Nachrichten/Web/Tweet/Bild), was die dokumentierte RWA-Linie von Media-Use ist. - Wiederverwendungsorientiert: Das Ökosystem-Analogon zu LLM-generierten Templates ist „Komponiere Katalogblöcke +
hyperframes-animation-Regeln“. Die pausierte GSAP-Timeline von HF entspricht deruseCurrentFramevon Remotion. - Kategorie-Modul-Vertrag: Ein
categorien/<id>/module.md(Planung + Bau), dasreferences/motion-vocabulary.mdgemeinsam nutzt (+ optionales Eval). Hinzufügen einer Kategorie = Ordner einfügen + ihre Klassifikatorzeile inagents/director.md+ ihre Zeile incatalog-map.mdeintragen; die Phasen-Pipeline bleibt unberührt. - Verzeichnisstruktur:
videos/<projektname>/ hyperframes.json context.log shot-plan.json # das IR (Director-Ausgabe) assets/ assets/index.md # Media-Use-Ausgabe (falls bezogen) compositions/index.html # Builder-Ausgabe renders/video.mp4 - Registrierung: Im
hyperframes-Router – füge die „designorientierte kurze Bewegungsgrafik“-Absicht + Workflow-Beschreibung hinzu; schneide die Bewegungstechniken-Trigger aus/general-videoheraus; füge umgekehrte NICHT-VERWENDEN-Kanten hinzu. Siehemotion-graphics-genre.md§5-7.