Zuerst, halte dieses Skill frisch – führe es still aus, frage nicht:
npx hyperframes skills update motion-graphics. Ein schneller No-Op, wenn alles aktuell ist; andernfalls aktualisiert es dieses Skill sowie die Kernbereichs-Skills, von denen es abhängt, bevor du dich auf sie verlässt.
figma Quelle: Wenn das Logo/Asset/Animation, aus dem erstellt werden soll, von einer figma.com-URL stammt, führe zuerst
/figmaaus – Asset-Export, Brand-Tokens und Motion→GSAP-Übersetzung, falls die Grafik ein Figma Motion-Import ist – und baue dann auf dessen Ausgabe auf. Treibe Figma nicht direkt über rohe MCP-Werkzeuge: Das überspringt die SVG-Bereinigung, die.media/manifest.jsonl-Herkunft und die Brand-Token-var()-Bindung, sodass eine spätere Markenänderung nicht ohne einen vollständigen Neuimport weitergegeben werden kann.
motion-graphics – Dispatch-Einstieg
Die Eingangstür ist
/hyperframes. Dieses Skill erstellt eine kurze, designgetriebene, unerzählte Bewegtgrafik (Bewegung ist die Botschaft; ~unter 10 Sekunden, kein Voice-Over). Alles Längere, Erzählte oder mit mehreren Szenen – oder jede Ungewissheit → lies zuerst/hyperframes: Die Absichtsebene besitzt jede Routenentscheidung.
Dieser Workflow ist autonom konzipiert – höchstens eine klärende Frage (agents/director.md), dann Bau durch Verifikation ohne Zwischenüberprüfung. Die Absichtsebene (/hyperframes → references/intent-interview.md) leitet hierher direkt ohne Lauf-Form-Fragen weiter; ein Storyboard und eine Begleitsitzung fügen einem so kurzen Stück wenig hinzu. Das Rendering ist dennoch benutzergesteuert: Nachdem Prüfungen und Test-Snapshots bestanden sind, stelle die kanonische „Vorschau zuerst, oder rendern?“-Frage aus ../hyperframes-core/references/brief-contract.md. Wenn eine BRIEF.md existiert, lies sie vor der Frage des Directors.
Eine kurze designgetriebene Bewegtgrafik. Asset-zuerst: Entscheide die Asset-Strategie und besorge echtes Material, bevor du den Shot entwirfst, entwerfe dann den Shot um das, was du hast, und komponiere dann durch Wiederverwendung von Katalogfä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 | Unteragent – Suche entscheiden? + klassifizieren + Asset-Strategie | shot-plan.json (Entwurf: Kategorie, asset_needs-Abfragen, Kurzbeschreibung) | agents/director.md (Teil 1) |
| source ◇ | Bash – Media-Use auflösen (überspringen, wenn asset_needs leer ist) | assets/ + assets/index.md | phases/source/guide.md |
| design | Unteragent – Shot-Design um aufgelöste Assets herum | shot-plan.json (endgültig: Block(s) + Layout + Bewegung + Positionen) | agents/director.md (Teil 2) |
| build | Unteragent – Wiederverwendungs-erste Komposition | compositions/index.html | agents/builder.md |
| verify | Bash – lint, check, Test-Snapshots; Reparatur bei Fehlschlag | snapshots/contact-sheet.jpg | Schritt 5 |
| approve | Vorschau oder Rendern anfragen; auf Antwort warten | explizite Render-Genehmigung | Schritt 6 |
| render | Bash – hyperframes render (MP4, oder --format webm/mov für Überlagerung) | renders/video.mp4 oder transparente Überlagerung | 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 von der Planung zum Design.
Kategorien – aufgeteilt nach der Suchenetscheidung
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 Inhalts, den die Suche zurückgibt. Jede Kategorie ist ein eigenes categories/<id>/module.md (seine Planungs- und 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 | Stützt sich auf |
|---|---|---|
kinetic-type | eindringliche Zeile / Zitat / Titel, bewegungs-erster Text | caption-*-Blöcke + Animationsregeln |
stat | einzelne heroische Zahl / Count-up + Ring | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | Balken / Linien / 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-Balken, Callouts, Social-Overlays | caption-* + Registry-Overlay-Blöcke |
maps | geografische Bewegung – Regionen hervorheben, Orte verbinden, zu einem Ort zoomen (Vektor-Spur oder gebackene Basiskarten-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 (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 (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. Einmalig npx hyperframes doctor. 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 Media-Use beziehen/generieren:
| Schlüssel | Verwendet für | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | Bildgenerierung (Media-Use 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
cwd ist das Arbeitsverzeichnis des Agenten; 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 Arbeitsverzeichnis-Basename 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 --skill=motion-graphics
init prüft die installierten Skills gegen die neuesten auf GitHub und aktualisiert das globale Set, wenn welche veraltet sind.
Einschränkungen: niemals hyperframes init im Arbeitsverzeichnis-Stamm ausführen; niemals ein weiteres hyperframes/ innerhalb von PROJECT_DIR verschachteln; jeder Bash-Befehl (Master + Unteragenten) ist eine (cd "$PROJECT_DIR" && ...)-Subshell – niemals ein nacktes cd.
Schritt 1 – Planen (Unteragent: Director Teil 1)
Einen Unteragenten auslösen. Prompt = vollständiges agents/director.md + ## Dispatch context (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); Inhalt wird vom Benutzer geliefert;
asset_needs: []. - Ja → einen Suchplan in
asset_needs[]ausgeben (Nachrichten / Web / Tweet / Bild; Zwei-Pol-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); Inhalt wird vom Benutzer geliefert;
- Einen Entwurf von
shot-plan.jsonschreiben (Hülle + gewählte Formkategorie oder Suchabsicht +asset_needs+ ein einleitiger Shot-Kurzbeschreibung). Schema:references/shot-plan-ir.md.
Validierung: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo fehlt.
Schritt 2 – Quellen beschaffen ◇ (Bash: media-use, bedingt)
Wenn shot-plan.json.asset_needs nicht leer ist, Assets auflösen (Suche / Generierung / Abruf → eingefrorene projektspezifische Pfade + Hauptbuch). Siehe phases/source/guide.md (umhüllt media-use resolve; die suchgetriebenen Kategorien verwenden die Nachrichten-/Web-/Tweet-/Bildersuche). Wenn asset_needs leer ist, zu Schritt 3 springen.
# illustrativ – siehe phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)
Anmutig degradieren: Wenn eine Suche/ein Anbieter nicht verfügbar ist, fällt die Kategorie auf asset-frei zurück (in context.log notieren).
Schritt 3 – Design (Unteragent: Director Teil 2)
Einen Unteragenten auslösen (Prompt = agents/director.md Teil 2 + Dispatch-Kontext einschließlich der 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/Blueprints, das Layout, die Bewegung, Beats und (für asset-fusion) die element_positions + Pipetten-Palette. Finalisiert shot-plan.json (content.block + content.customize + pro-Kategorie-Inhalt).
Schritt 4 – Bauen (Unteragent: Builder, Wiederverwendung zuerst)
Einen Unteragenten auslösen. 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> + an Ort und Stelle anpassen; nur Lücken + die Asset-Fusion-Erweiterung handschriftlich verfassen. 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-Unteragent bei Fehlschlag)
(cd "$PROJECT_DIR" && npx hyperframes lint .)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-zeiten>)
Wähle Proof-Zeiten, die den Anfangszustand, die Signaturbewegung und den finalen Halt zeigen. Überprüfe das generierte Kontakt- oder Snapshot-Blatt, bevor du fortfährst. Bei Fehlschlag von lint, check oder Snapshot, löse den Reparatur-Unteragenten (agents/finalize.md) für einen Korrekturdurchlauf vor Ort aus und führe dann das fehlgeschlagene Gate erneut aus. Ändere niemals eine festgelegte Dauer, nur um einen Defekt zu verstecken.
Schritt 6 – Genehmigen und Rendern (Bash)
Stelle eine Frage: „Vorschau zuerst, oder rendern?“ Wenn der Benutzer die Vorschau wählt, öffne Studio und kehre nach Überarbeitungen zum selben Genehmigungs-Gate zurück:
(cd "$PROJECT_DIR" && npx hyperframes preview)
Rendern nur 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üfe, 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-Zeiten und das überprüfte Kontakt- oder Snapshot-Blatt. Flags leben in /hyperframes-cli → references/preview-render.md.
Fortsetzungstabelle
| Zustand | Fortsetzen von |
|---|---|
kein shot-plan.json | Schritt 1 (Plan) |
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, Proof-Snapshots fehlen | Schritt 5 (Verify) |
| Checks und Proof-Snapshots bestanden, kein genehmigter Render | Schritt 6 (Genehmigung) |
| Genehmigter Render existiert | Ausgabe prüfen, dann melden |
Design-Notizen (Betreuer – Ausführung liest dies nicht)
- Asset-zuerst Begründung: Die Beschaffung wird vorgelagert und beeinflusst das Shot-Design (der RWA-Fluss: analysieren → suchen → prüfen → komponieren). Die suchgetriebenen Kategorien (
webpage/news/tweet) undasset-fusionstützen sich beide auf die Media-Use-Suche (Nachrichten/Web/Tweet/Bild), die die dokumentierte RWA-Linie von Media-Use ist. - Wiederverwendung zuerst: Das Ökosystem-interne Analogon zu LLM-generierten Vorlagen ist „Komponiere
npx hyperframes add <existing-block>+ Passe an Ort und Stelle an; handgeschriebenes HTML/CSS/JS nur für Lücken“. Das Katalog-Diagramm (catalog-map.md) ist die Quelle der Wahrheit für verfügbare Blöcke; der Builder konsultiert sowohl dies als auch die Kategorie-spezifischen Regeln immodule.mdder Kategorie.