Bewegtgrafiken — Dispatch-Eintrag
Bestätige die Route vor Schritt 0. Dieser Skill erstellt eine kurze, designgetriebene, unerzählte Bewegtgrafik (Bewegung ist die Botschaft; ~unter 10 s, kein Voice-Over). Eine längere, szenenreiche oder erzählte Behandlung →
/general-video; ein erzähltes Video einer Website →/website-to-video; ein Themenerklärer →/faceless-explainer; ein Produkt-Promo →/product-launch-video; Untertitel auf vorhandenem Material →/embedded-captions. Außerhalb des Rahmens: Live-/Renderzeitdaten oder Material, das nicht aufgenommen werden kann. Unsicher, ob bewegungsorientiert oder erzählt? Lies zuerst/hyperframes.
Eine kurze, designgetriebene Bewegtgrafik. Asset-First: Entscheide die Asset-Strategie und besorge echtes Material, bevor du die Einstellung designst, gestalte dann die Einstellung um das Vorhandene herum und komponiere durch Wiederverwendung von Katalog-Fähigkeiten. 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 — Mediennutzung auflösen (ü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 (endgültig: 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 an Ort und Stelle) | 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 springen direkt von der Planung zum Design.
Kategorien — Aufteilung nach der Such-Entscheidung
Die erste Entscheidung von plan ist: Ist eine Suche nötig? 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 befindet sich 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 / 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 |
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) |
Baureihenfolge: einzeln, abdeckungsorientiert (Rohfassung 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 ausführen. macOS GPU-Rendering: export PRODUCER_BROWSER_GPU_MODE=hardware.
Optionale Schlüssel (lokale Fallbacks, falls nicht gesetzt) – nur benötigt von Kategorien, die Assets über Mediennutzung beschaffen/generieren:
| Schlüssel | Verwendet für | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | Bildgenerierung (Mediennutzung 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 — Initialisierung
CWD 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 nicht vorhanden ist:
PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<projektname>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank
init prüft die installierten Skills gegen die neuesten auf GitHub und aktualisiert die globale Sammlung, falls welche veraltet sind.
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 ein bloßes cd.
Schritt 1 — Planung (Subagent: Director Teil 1)
Einen Subagenten beauftragen. 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 nötig? (die erste Gabelung)
- Nein → eine Formkategorie wählen (kinetic-type / stat / charts / logo-reveal / lower-thirds); Inhalt wird vom Benutzer bereitgestellt;
asset_needs: []. - Ja → einen Suchplan in
asset_needs[]ausgeben (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 → eine Formkategorie wählen (kinetic-type / stat / charts / logo-reveal / lower-thirds); Inhalt wird vom Benutzer bereitgestellt;
- Einen Entwurf
shot-plan.jsonschreiben (Hülle + gewählte Formkategorie oder Suchabsicht +asset_needs+ ein einabsätziger Einstellungsbrief). Schema:references/shot-plan-ir.md.
Validierung: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo fehlt.
Schritt 2 — Quelle ◇ (Bash: Mediennutzung, bedingt)
Falls shot-plan.json.asset_needs nicht leer ist, Assets auflösen (Suchen / Generieren / Abrufen → eingefrorene projektspezifische Pfade + Hauptbuch). Siehe phases/source/guide.md (umhüllt media-use resolve; die suchgesteuerten Kategorien verwenden die Nachrichten-/Web-/Tweet-/Bildsuche). Falls asset_needs leer ist, zu Schritt 3 springen.
# zur Veranschaulichung — siehe phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)
Höflich degradieren: Wenn ein Such-/Anbieter nicht verfügbar ist, fällt die Kategorie auf asset-frei zurück (vermerken in context.log).
Schritt 3 — Design (Subagent: Director Teil 2)
Einen Subagenten beauftragen (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 gestaltet die Einstellung um die verfügbaren Assets herum: den/die Katalog-Block(s) + die hyperframes-animation-Regeln/Blaupausen, das Layout, die Bewegung, Beats und (für asset-fusion) die element_positions + Pipetten-Palette auswählen. Finalisiert shot-plan.json (content.block + content.customize + kategoriespezifischer Inhalt).
Schritt 4 — Aufbau (Subagent: Builder, Wiederverwendungsorientiert)
Einen Subagenten beauftragen. 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> + anpassen an Ort und Stelle; nur Lücken + die asset-fusion-Ausstattung von Hand erstellen. Ausgabe compositions/index.html, das den HF-Vertrag einhält (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 — Überprüfen (Bash → Reparatursubagent bei Fehlschlag)
(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)
exit 0 → erledigt. Bei Lint-/Inspect-Fehlern den Reparatursubagenten beauftragen (agents/finalize.md: Schnappschuss-QA + ein In-Place-Fix-Durchlauf + Neu-Rendering). Nie eine festgelegte Dauer während der Reparatur ändern.
Bericht + optionale Vorschau
Über das endgültige Ergebnis berichten (renders/video.mp4 oder die .webm- / .mov-Overlay-Variante) + Dauer. Während des Laufs keine Vorschau öffnen. Nur auf Anfrage anbieten, gestartet nach dem Rendern, damit es die endgültige Datei bereitstellt:
(cd "$PROJECT_DIR" && npx hyperframes preview) # Studio-Benutzeroberfläche; oder `npx hyperframes play` für einen teilbaren Link
Flags befinden sich im hyperframes-cli-Skill (references/preview-render.md).
Fortsetzungstabelle
| Zustand | Fortsetzen ab |
|---|---|
kein shot-plan.json | Schritt 1 (Planung) |
shot-plan.json hat asset_needs, kein assets/ | Schritt 2 (Quelle) |
shot-plan.json endgültig, kein compositions/index.html | Schritt 3/4 (Design+Bau) |
compositions/index.html existiert, kein renders/video.mp4 | Schritt 5 (Rendern) + Schritt 6 |
renders/video.mp4 existiert | Bericht + Stopp |
Design-Hinweise (Betreuer — die Ausführung liest dies nicht)
- Asset-First-Begründung: Die Beschaffung wird vorangestellt und informiert das Einstellungsdesign (der RWA-Ablauf: analysieren → suchen → prüfen → komponieren). Die suchgesteuerten Kategorien (
webpage/news/tweet) undasset-fusionstützen sich beide auf die Mediennutzungssuche (news / web / tweet / image), was die dokumentierte RWA-Linie der Mediennutzung ist. - Wiederverwendungsorientiert: Das Ökosystem-interne Analogon zu LLM-generierten Vorlagen ist „Katalogblöcke +
hyperframes-animation-Regeln komponieren“. Die pausierte GSAP-Timeline von HF entspricht RemotionsuseCurrentFrame. - Kategorie-Modul-Vertrag: Ein
categories/<id>/module.md(Planung + Bau), dasreferences/motion-vocabulary.mdgemeinsam nutzt (+ optionales Eval). Hinzufügen einer Kategorie = Ordner ablegen + seine Klassifiziererzeile inagents/director.mdregistrieren + seine Zeile incatalog-map.md; die Phasen-Pipeline bleibt unberührt. - Verzeichnisstruktur:
videos/<projektname>/ hyperframes.json context.log shot-plan.json # das IR (Director-Ausgabe) assets/ assets/index.md # Mediennutzung-Ausgabe (falls beschafft) compositions/index.html # Builder-Ausgabe renders/video.mp4 - Registrierung: Im
hyperframes-Router – die Absicht „designgetriebene kurze Bewegtgrafik“ + Workflow-Beschreibung hinzufügen; die motion-graphics-Trigger aus/general-videoherausschneiden; umgekehrte NICHT-VERWENDEN-Kanten hinzufügen. Siehemotion-graphics-genre.md§5-7.