Communitygithub.com

Army161/OpenMontage

Verwenden, wenn der Benutzer ein kurzes, designgetriebenes Bewegtbild wünscht, bei dem Bewegung die Botschaft ist: kinetische Typografie, Statistik- oder Zahlen-Hochzählen, Diagramm-/Datenvisualisierungs-Hit, Logo-Sting, Brand-Lockup, Lower-Third, Callout, Social-Overlay, animierte Schlagzeile/Tweet/News-Beitrag, Bewegtplakat oder kurzer hervorgehobener Seitenausschnitt. Normalerweise unter 10s und bis zu ~30s, ohne Erzählbogen, Voice-Over oder Realdarsteller. Kann als MP4 oder transparentes Overlay gerendert werden. Nicht geeignet für längere, szenenreiche, erzählte oder Markenreel-Stücke (allgemeines Video), erzählte Website-Videos (Website-zu-Video), Themenerklärer (gesichtsloser Erklärer), Produkt-Promos (Produkt-Launch-Video), PR-Videos (PR-zu-Video) oder Untertitel auf vorhandenem Material (eingebettete Untertitel). Bei Unsicherheit, ob es sich um ein kurzes, bewegungsorientiertes Stück oder eine längere/erzählte Behandlung handelt, siehe /hyperframes.

Was ist OpenMontage?

OpenMontage ist ein KI-Agenten-Skill zur Erstellung kurzer, designorientierter Bewegtgrafiken, bei denen die Bewegung selbst die Botschaft ist – ohne Voice-Over oder Erzählbogen. Es eignet sich perfekt für Formate wie kinetische Typografie, Zahlen-Hochzählen, Diagrammanimationen, Logo-Stings, Lower-Thirds und animierte Social-Media-Overlays. Der Skill folgt einem klaren, sechsstufigen Workflow: Initialisierung, Planung (inklusive Entscheidung, ob eine Suche nötig ist), Asset-Beschaffung, Design, Aufbau und Rendering. Er nutzt das Hyperframes-Framework und unterstützt sowohl formularbasierte Kategorien (bei denen der Benutzer den Inhalt liefert) als auch suchgesteuerte Kategorien (bei denen zuerst nach Webseiten, Nachrichten, Tweets oder Bildern gesucht wird). Durch die Asset-First-Strategie wird sichergestellt, dass das Design um die tatsächlich verfügbaren Materialien herum aufgebaut wird. Der Skill ist ideal für schnelle, visuell eindrucksvolle Clips von unter 10 Sekunden bis etwa 30 Sekunden und rendert als MP4 oder transparentes Overlay. Bei längeren, erzählten oder szenenreichen Projekten wird auf andere Skills wie `general-video` oder `faceless-explainer` verwiesen.

Funktioniert mit~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/Army161/OpenMontage/tree/HEAD/.agents/skills/motion-graphics

In Ihrer bevorzugten KI fragen

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

Dokumentation

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.

PhaseAusführungPrimäres ArtefaktDetaillierter Ablauf
initBashhyperframes.jsonSchritt 0
planSubagent — Suche entscheiden? + klassifizieren + Asset-Strategieshot-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.mdphases/source/guide.md
designSubagent — Einstellungsdesign um aufgelöste Assets herumshot-plan.json (endgültig: Block(s) + Layout + Bewegung + Positionen)agents/director.md (Teil 2)
buildSubagent — Wiederverwendungsorientierte Kompositioncompositions/index.htmlagents/builder.md
renderBash — hyperframes render (MP4, oder --format webm/mov für Overlay)renders/video.mp4Schritt 5
verifyBash — 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:

KategorieAbsichtStützt sich auf
kinetic-typePrägnante Zeile / Zitat / Titel, bewegungsorientierter 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-/Titelbalken, Callouts, Social-Overlayscaption-* + Registry-Overlay-Blöcke

Suchgesteuerte Kategorien — zuerst suchen, dann nach Inhaltstyp animieren (der RWA-Pfad):

Zurückgegebener InhaltKategorieAnimation
Webseite / LinkwebpageWebseiten-/UI-Animation (Scrollen, Enthüllen, Cursor, Callouts)
NachrichtenartikelnewsSchlagzeilen-Enthüllung + Quellenkarte + Schlüsselfakt-Callouts
TweettweetAnimierte Tweet-Karte
Bild / Entitätasset-fusionDie 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üsselVerwendet fürFallback
GEMINI_API_KEY / GOOGLE_API_KEYBildgenerierung (Mediennutzung auflösen)Generierung überspringen / Nur-Suche
(asset_scout / Suchanbieter)webpage/news/tweet + asset-fusion Echt-Asset-SucheKategorie 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:

  1. 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.
  2. Einen Entwurf shot-plan.json schreiben (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

ZustandFortsetzen ab
kein shot-plan.jsonSchritt 1 (Planung)
shot-plan.json hat asset_needs, kein assets/Schritt 2 (Quelle)
shot-plan.json endgültig, kein compositions/index.htmlSchritt 3/4 (Design+Bau)
compositions/index.html existiert, kein renders/video.mp4Schritt 5 (Rendern) + Schritt 6
renders/video.mp4 existiertBericht + 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) und asset-fusion stü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 Remotions useCurrentFrame.
  • Kategorie-Modul-Vertrag: Ein categories/<id>/module.md (Planung + Bau), das references/motion-vocabulary.md gemeinsam nutzt (+ optionales Eval). Hinzufügen einer Kategorie = Ordner ablegen + seine Klassifiziererzeile in agents/director.md registrieren + seine 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   # 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-video herausschneiden; umgekehrte NICHT-VERWENDEN-Kanten hinzufügen. Siehe motion-graphics-genre.md §5-7.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Army161/OpenMontage

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax). Supports two gateways: HeyGen API and fal.ai API.

Army161/OpenMontage

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Army161/OpenMontage

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Army161/OpenMontage

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Army161/OpenMontage

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Army161/OpenMontage

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Army161/OpenMontage

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Army161/OpenMontage

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Army161/OpenMontage

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Army161/OpenMontage

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Army161/OpenMontage

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Army161/OpenMontage

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Army161/OpenMontage

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Army161/OpenMontage

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Army161/OpenMontage

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

Army161/OpenMontage

Best practices for Remotion - Video creation in React

Army161/OpenMontage

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Army161/OpenMontage

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

Army161/OpenMontage

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

Army161/OpenMontage

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

Verwandte Skills