Communitygithub.com

content-system

Erstellt kurze, design-getriebene Bewegtgrafiken (Motion Graphics) unter 10 Sekunden ohne Voice-Over: kinetische Typografie, Statistiken, Diagramme, Logo-Stings oder animierte UI-Elemente.

Was ist content-system?

Dieser Skill erzeugt kurze, designorientierte Motion Graphics, bei denen die Bewegung die Botschaft trägt. Er eignet sich für kinetische Typografie, Zahlen-Count-ups, Diagramme, Logo-Reveals, Lower-Thirds, Social Overlays und animierte Schlagzeilen – normalerweise unter 10 Sekunden, maximal etwa 30 Sekunden, ohne Erzählbogen oder Voice-Over. Der Skill arbeitet asset-zentriert: Zuerst wird die Asset-Strategie festgelegt, dann das eigentliche Material beschafft, bevor das Shot-Design um diese Assets herum erfolgt. Plattformen: macOS Apple Silicon oder Linux x64; Voraussetzungen sind Node.js, ffmpeg und das Tool 'hyperframes'. Die Ausgabe erfolgt als MP4 oder als transparentes Overlay (WebM/MOV). Der Workflow durchläuft sechs Phasen: Initialisierung, Planung (mit Entscheidung über Suche), Quellensuche (optional), Design, Build und Rendering. Der Skill unterscheidet zwischen Formkategorien (keine Suche nötig, z.B. kinetische Typografie, Statistik, Diagramme) und suchgetriebenen Kategorien (z.B. Webseiten, Nachrichten, Tweets). Die Wiederverwendung vorhandener Katalogblöcke und Animationsregeln steht im Vordergrund, was den Prozess effizient und konsistent macht.

Funktioniert mit~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/The-Ai-automation-Queen/content-system/tree/HEAD/skills/hyperframes/motion-graphics

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Motion-Graphics — Dispatch-Eintrag

Bestätige den Pfad vor Schritt 0. Dieser Skill erstellt eine kurze, design-getriebene, unerzählte Bewegtgrafik (Bewegung ist die Botschaft; ~unter 10s, kein Voice-Over). Eine längere, mehrszene oder erzählte Behandlung → /general-video; ein erzähltes Video einer Website → /website-to-video; eine Themenerklärung → /faceless-explainer; ein Produktpromo → /product-launch-video; Untertitel auf vorhandenem Material → /embedded-captions. Nicht im Rahmen: Live-/Renderzeit-Daten oder Material, das nicht erfasst werden kann. Unsicher ob Bewegungsfokus oder Erzählung? Lies zuerst /hyperframes.

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 Vorhandene herum und komponiere durch Wiederverwendung von Katalogfähigkeiten. Alle Artefakte gehen nach PROJECT_DIR = videos/<projektname>/ (erstellt in Schritt 0); alle nachfolgenden Pfade sind relativ dazu.

PhaseAusführungPrimäres ArtefaktDetaillierter Ablauf
initBashhyperframes.jsonSchritt 0
planSubagent — entscheide über Suche? + klassifiziere + Asset-Strategieshot-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.mdphases/source/guide.md
designSubagent — Shot-Design um aufgelöste Assets herumshot-plan.json (final: Block(s) + Layout + Bewegung + Positionen)agents/director.md (Teil 2)
buildSubagent — Wiederverwendungs-erste Kompositioncompositions/index.htmlagents/builder.md
renderBash — hyperframes render (MP4, oder --format webm/mov für Overlay)renders/video.mp4Schritt 5
verifyBash — lint / inspect -> Reparatur-Subagent bei Fehlschlag(Reparaturen 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 – 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- 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:

KategorieAbsichtStützt sich auf
kinetic-typeeindringliche Zeile / Zitat / Titel, bewegungsfokussierter Textcaption-*-Blöcke + Animationsregeln
stateinzelne Heldenzahl / Count-up + Ringapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsBalken / Linie / Kreis / Rennen / % aus Datendata-chart-Block
logo-revealLogo-Sting / Brand-Lockup (Benutzer-Logo)logo-outro / rules/svg-path-draw
lower-thirdsNamens-/Titel-Leisten, Callouts, Social Overlayscaption-* + Registry-Overlay-Blöcke

Suchgetriebene Kategorien – zuerst suchen, dann nach Inhaltstyp animieren (der RWA-Pfad):

Zurückgegebener InhaltKategorieAnimation
Webseite / LinkwebpageWebseiten-/UI-Animation (Scroll, Reveal, Cursor, Callouts)
NachrichtenartikelnewsHeadline-Reveal + Quellenkarte + Schlüsselfakt-Callouts
Tweettweetanimierte Tweet-Karte
Bild / Entitätasset-fusionDie Geometrie des Assets wird zum Diagramm (RWA diegetische Fusion)

Baureihenfolge: einzeln nach Abdeckung (skizzenhaft ist in Ordnung). kinetic-type aus dem Prototypen portiert; der Rest folgt.

Voraussetzungen

macOS Apple Silicon oder Linux x64. Systemtools: 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) – werden nur von Kategorien benötigt, die Assets über Media-Use beschaffen/generieren:

SchlüsselVerwendet fürFallback
GEMINI_API_KEY / GOOGLE_API_KEYBildgenerierung (Media-Use-Auflösung)generate überspringen / nur suchen
(asset_scout / Suchanbieter)webpage/news/tweet + asset-fusion Echt-Asset-SucheKategorie verfällt zu asset-frei

Ablauf

Schritt 0 — Initialisierung

Das Arbeitsverzeichnis (cwd) ist das Root des Agent-Workspace; 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-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

init prüft die installierten Skills gegen die neuesten auf GitHub und aktualisiert das globale Set, falls welche veraltet sind.

Einschränkungen: Niemals hyperframes init im Workspace-Root ausführen; niemals ein weiteres hyperframes/ in PROJECT_DIR verschachteln; jeder Bash-Befehl (Master + Subagents) ist eine (cd "$PROJECT_DIR" && ...)-Subshell – niemals ein bloßes cd.

Schritt 1 — Planung (Subagent: Director Teil 1)

Einen Subagenten ausführen. Prompt = vollständiges agents/director.md + ## Dispatch-Kontext (SKILL_DIR / PROJECT_DIR / die Benutzeranfrage / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Er muss:

  1. Entscheiden: Braucht dies eine Suche? (die erste Gabelung)
    • Nein → eine Formkategorie wählen (kinetic-type / stat / charts / logo-reveal / lower-thirds); Inhalt wird vom Benutzer geliefert; asset_needs: [].
    • Ja → einen Suchplan in asset_needs[] ausgeben (news / web / tweet / image; 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.
  2. Einen Entwurf shot-plan.json schreiben (Hülle + gewählte Formkategorie oder Suchintention + asset_needs + ein einleitiger Shot-Brief). Schema: references/shot-plan-ir.md.

Validierung: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.

Schritt 2 — Quelle ◇ (Bash: Media-Use, bedingt)

Falls shot-plan.json.asset_needs nicht leer ist, Assets auflösen (Suche / Generierung / Abruf → eingefrorene projektspezifische Pfade + Ledger). Siehe phases/source/guide.md (wrapper für media-use resolve; die suchgetriebenen Kategorien verwenden die News/Web/Tweet/Bild-Suche). Falls asset_needs leer ist, weiter 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 Anbieter nicht verfügbar ist, fällt die Kategorie auf asset-frei zurück (vermerkt in context.log).

Schritt 3 — Design (Subagent: Director Teil 2)

Einen Subagenten ausführen (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 den Shot um die verfügbaren Assets herum: wählt die Katalogblöcke + die hyperframes-animation-Regeln/Blaupausen, das Layout, die Bewegung, Beats und (für asset-fusion) die element_positions + Eye-Dropper-Palette. Finalisiert shot-plan.json (content.block + content.customize + pro-Kategorie Inhalt).

Schritt 4 — Build (Subagent: Builder, Wiederverwendungs-erste)

Einen Subagenten ausführen. 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). Wiederverwendungs-erste: npx hyperframes add <block> + Anpassung an Ort und Stelle; nur Lücken + die Asset-Fusion-Fähigkeit von Hand 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 — 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 → Reparatur-Subagent bei Fehlschlag)

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

Exit 0 → fertig. Bei Lint/Inspect-Fehlern den Reparatur-Subagenten ausführen (agents/finalize.md: Snapshot-QA + ein Reparaturdurchlauf an Ort und Stelle + erneutes Rendern). Niemals eine festgelegte Dauer während der Reparatur ändern.

Bericht + optionale Vorschau

Berichte über die endgültige Ausgabe (renders/video.mp4 oder die .webm / .mov Overlay-Variante) + Dauer. Öffne keine Vorschau während des Laufs. Biete sie nur auf Anfrage an, gestartet nach dem Rendern, damit sie die endgültige Datei ausliefert:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Studio-UI; oder `npx hyperframes play` für einen teilbaren Link

Flags befinden sich im hyperframes-cli Skill (references/preview-render.md).

Fortsetzungstabelle

ZustandFortsetzen ab
kein shot-plan.jsonSchritt 1 (Planung)
shot-plan.json hat asset_needs, kein assets/Schritt 2 (Quelle)
shot-plan.json final, kein compositions/index.htmlSchritt 3/4 (Design+Build)
compositions/index.html existiert, kein renders/video.mp4Schritt 5 (Rendern) + Schritt 6
renders/video.mp4 existiertBericht + Stopp

Design-Notizen (Betreuer – die Ausführung liest dies nicht)

  • Asset-Zuerst Begründung: Die Beschaffung wird vorgeladen und beeinflusst das Shot-Design (der RWA-Ablauf: analysieren → suchen → prüfen → komponieren). Die suchgetriebenen Kategorien (webpage/news/tweet) und asset-fusion stützen sich beide auf die Media-Use-Suche (news/web/tweet/image), welche die dokumentierte RWA-Abstammungslinie von Media-Use ist.
  • Wiederverwendungs-erste: Das Ökosystem-Analogon zu LLM-generierten Vorlagen ist „Katalogblöcke + hyperframes-animation-Regeln komponieren". Die pausierte GSAP-Timeline von HF entspricht Remotions useCurrentFrame.
  • Kategorie-Modulvertrag: Ein categories/<id>/module.md (Planung + Build), das references/motion-vocabulary.md gemeinsam nutzt (+ optionales eval). Eine Kategorie hinzufügen = Ordner ablegen + ihre Klassifikationszeile in agents/director.md registrieren + ihre Zeile in catalog-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  # Media-Use-Ausgabe (falls beschafft)
      compositions/index.html   # Builder-Ausgabe
      renders/video.mp4
    
  • Registrierung: Im hyperframes Router – die Absicht „design-getriebene kurze Bewegtgrafik" + Workflow-Beschreibung hinzufügen; die Motion-Graphics-Trigger aus /general-video heraustrennen; umgekehrte DO-NOT-USE-Kanten hinzufügen. Siehe motion-graphics-genre.md §5-7.

Verwandte Skills