Communitygithub.com

Army161/OpenMontage

Erfasse eine beliebige Website/URL und verwandle sie in ein HyperFrames-Video (Website-Tour, Showcase oder Social-Clip basierend auf den eigenen visuellen Elementen der Seite). Nutzt Headless-Chrome-Screenshots + Marken-Assets.

Was ist OpenMontage?

Army161/OpenMontage ist ein AI-Agenten-Skill, der eine beliebige Website in ein professionelles HyperFrames-Video verwandelt – ideal für Portfolio-Showease, Blog-Vorstellungen oder Social-Media-Clips, die die visuelle Identität der Website nutzen. Der Skill führt den Benutzer durch einen strukturierten 7-Schritte-Workflow: Startend mit der Erfassung und Analyse der Marke (Schritt 0), über die Definition der Markenidentität (Schritt 1), der Strategie und Botschaft (Schritt 2), dem Storyboard und Drehbuch (Schritt 3), der Sprachausgabe und Untertitelung (Schritt 4), dem Bau der Kompositionen (Schritt 5) bis hin zur Validierung und Auslieferung des fertigen Videos (Schritt 6). Der Skill unterstützt sowohl einen kollaborativen Modus mit Benutzerentscheidungen als auch einen autonomen Modus für Präferenzfragen, behält jedoch kritische Qualitätssicherungsschritte stets bei. Er ist nicht geeignet für reine Produkt-Launch-Videos, thematische Erklärvideos ohne Website, GitHub-PR-Demos oder das Hinzufügen von Untertiteln zu bestehenden Videos – hierfür gibt es spezialisierte Skills. Die Ausgabe erfolgt als lokales Studio-Projekt, das auf expliziten Wunsch in MP4 gerendert werden kann.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Army161/OpenMontage/tree/HEAD/.agents/skills/website-to-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

media-use: Bevor Audioquellen/Bilder beschafft werden, rufe /media-use auf, um Hintergrundmusik/Soundeffekte/Bilder aus dem HeyGen-Katalog zu beziehen. Führe zuerst --adopt aus, um vorhandene Assets zu registrieren. Siehe /media-use-Skill.

Website zu HyperFrames

Erfasse eine Website und erstelle daraus ein professionelles Video.

Bestätige den Pfad vor Schritt 0. Dieser Skill erstellt ein Video von / aus einer allgemeinen Website. Wenn der Benutzer tatsächlich ein Produkt vermarktet / launcht / bewirbt (selbst von dieser URL, selbst „Promo für unsere Seite“) → /product-launch-video. Ein Themenerklärer ohne Website → /faceless-explainer; ein GitHub-PR → /pr-to-video; ein vorhandenes Video neu schneiden / einfärben / anordnen → nicht im Rahmen. Hier gelandet bei vager Anweisung „Erstelle ein Video“ oder unsicher, ob Launch oder allgemeine Website? Lies zuerst /hyperframes (vollständige Routingtabelle + § Was HyperFrames nicht kann).

Benutzer sagen Dinge wie:

  • „Verwandle diese Website in einen 15-Sekunden-Social-Clip für Instagram“
  • „Erstelle eine 30-Sekunden-Website-Tour / Showcase von https://...“
  • „Erfasse unsere Startseite und baue ein Video aus ihren eigenen visuellen Elementen“

Der Workflow hat 7 Schritte. Jeder erzeugt ein Artefakt, das den nächsten Schritt freischaltet. Standardmäßig ist er kollaborativ – mit 💬 markierte Tore stoppen und fragen den Benutzer. Signalisiert der Benutzer den autonomen Modus („entscheide für mich“, „überrasche mich“), werden 💬 Tore mit Benutzerpräferenzen übersprungen; siehe step-2-brief.md für die Auswirkungen.

Der autonome Modus bedeutet NICHT „alle Tore überspringen“. Der Automatikmodus deckt Benutzerpräferenzfragen ab (TTS-Anbieter, Stimme, Farbakzente, Anzahl Beats, Musik ja/nein, Untertitel ja/nein – bei denen der Agent anstelle des Benutzers entscheidet). Er deckt NICHT Qualitätssicherungstore ab. Die folgenden Tore bleiben auch im Automatikmodus nicht überspringbar:

  • Asset-Audit (Schritt 3) – Kontaktbögen ansehen und USE/SKIP für jedes Asset rechtfertigen
  • Pro-Beat-HTML-Lesen (Schritt 5) – strukturierter Nachweisblock pro Beat
  • DoD-Checkliste (Schritt 6) – einschließlich Animations-Map, WCAG-Überprüfung pro Warnung, Audio/Bewegungswiedergabe
  • Ehrlicher Offenlegungsabschnitt (Schritt 6) – „Was ich NICHT verifiziert habe“ muss in der endgültigen Zusammenfassung erscheinen

Wenn du denkst „Automatikmodus bedeutet Tendenz zum Handeln, also überspringe ich X“ – und X ist ein Verifikationstor, keine Präferenzfrage – dann ist diese Überlegung falsch. Die Tendenz zum Handeln gilt für die Entscheidung, was gebaut werden soll, nicht für die Entscheidung, ob verifiziert werden soll.


Schritt 0: Erfassen und Verstehen der Marke

Lies: references/step-0-capture.md

Erfasse die Website, lies dann die extrahierten Daten, um die Marke und das Produkt zu verstehen – was es tut, für wen es ist, welche Stimme es spricht, in welcher Stimmung es lebt. Die erfassten Assets sind ein Marken-Werkzeugkasten für später, nicht die Bausteine, aus denen das Video besteht.

Zeige den Anmeldestatus vor dem Briefing – führe npx hyperframes auth status aus und gib die Ausgabe wörtlich wieder (paraphrasiere oder schreibe sie nicht um). Es wird gemeldet, ob Sprache/Hintergrundmusik HeyGen oder lokale Engines verwendet und, wenn nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, STOP und warte auf die Wahl des Benutzers – anmelden oder „go“/„offline“ sagen, um mit lokalen Engines fortzufahren – bevor du nach dem Briefing oder irgendetwas anderem fragst. Behandle es als echten Entscheidungspunkt, nicht als beiläufige Notiz; klappe die Wahl nicht in die Briefing-Frage ein und schreibe keine Schlüssel in eine pro-Repo .env-Datei. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die kanonische Anleitung.

Tor: Site-Zusammenfassung gedruckt – zuerst die Strategie (was das Produkt tut, für wen es ist, Markenstimme) vor dem Asset-/Farb-/Schriftinventar; Anmeldestatus wurde angezeigt (angemeldet oder Fortsetzung offline).


Schritt 1: Markenidentität

Lies: references/step-1-design.md

Schreibe DESIGN.md – ein Marken-Spickzettel über die visuelle Identität: Farben, Typografie, Komponentenstile, Layout-Prinzipien. Verwende design-styles.json für exakte berechnete Werte.

Geschwindigkeitsoption: Für schnell geschnittene Videos (Billboard-pro-Beat) kann DESIGN.md eine 50-zeilige Zusammenfassung von Farben + Schriften + Do's/Don'ts sein – kein 300-zeiliges Dokument. Der Sub-Agent-Prompt in Schritt 5 fügt Markenwerte direkt ein, daher ist die Tiefe von DESIGN.md nur für komplexe Kompositionen relevant.

Tor: DESIGN.md existiert (beliebige Länge) mit mindestens: Farbpalette, Schriftauswahl und Do's/Don'ts.


Schritt 2: Strategie und Botschaft

Lies: references/step-2-brief.md, references/capabilities.md (scanne das Inhaltsverzeichnis – ausführliche Abschnitte nur bei Bedarf)

Stimme dich mit dem Benutzer ab, was das Video kommunizieren muss, bevor du über Bilder oder Assets sprichst. Analysiere die Eingabe des Benutzers – er hat dir wahrscheinlich bereits den Videotyp und -stil genannt. Frage nur nach dem, was fehlt: die EINE Sache, die dieses Video sagen muss, der narrative Bogen und die Zielgruppe.

Tor: Videotyp, Dauer, Format und – entscheidend – die Botschaft und der narrative Bogen sind festgelegt. Ohne diese kann Schritt 3 kein konzeptorientiertes Storyboard schreiben.


Schritt 3: Storyboard + Drehbuch 💬

Lies: references/step-3-storyboard.md

Schreibe das Storyboard konzeptorientiert: Botschaft → narrativer Bogen → Beats, die dem Bogen dienen → Techniken pro Beat → Markenakzente am Ende. Schreibe dann das Erzählskript passend dazu. Präsentiere beides dem Benutzer mit einer Beat-für-Beat-Zusammenfassung. Wiederhole, bis er zustimmt.

Tor: STORYBOARD.md + SCRIPT.md existieren UND der Benutzer hat den Plan genehmigt.


Schritt 4: Sprachausgabe, Timing + Untertitel 💬

Lies: references/step-4-vo.md

Wenn Schritt 2 „keine Erzählung“ vorgesehen hat – frage nach Hintergrundmusik, springe dann zu Schritt 5. Andernfalls: frage den Benutzer nach dem TTS-Anbieter (HeyGen TTS, ElevenLabs oder Kokoro), generiere Audio, transkribiere, ordne Zeitstempel den Beats zu. Frage dann nach Untertiteln.

Tor: Entweder (a) es wurde keine Erzählung gewünscht und das Storyboard hat manuelle Beat-Timings, oder (b) narration.wav + transcript.json existieren und Beat-Timings wurden mit echten Dauern aktualisiert.


Schritt 5: Kompositionen erstellen

Lies: Den hyperframes-Skill (lade ihn – jede Regel zählt) Lies: references/step-5-build.md

Erstelle index.html und Kompositionen gemäß der im Storyboard (Schritt 3) gewählten Architektur und des Timings. Sub-Agenten führen hyperframes lint und hyperframes snapshot für jeden Beat aus, bevor sie zurückmelden.

Tor: Jede compositions/beat-N.html wurde vom Haupt-Agenten von oben bis unten gegen DESIGN.md und STORYBOARD.md gelesen. Die Pro-Beat-Checkliste befindet sich in step-5-build.md.


Schritt 6: Validieren und Ausliefern

Lies: references/step-6-validate.md

Linten, validieren, Screenshots erstellen, skaliert auf die Videolänge (Formel: max(beats × 3, ceil(duration_seconds / 2))), und jeden überprüfen. Behebe Probleme vor der Auslieferung. Liefere die lokale Studio-Projekt-URL aus – rendere nur auf expliziten Benutzerwunsch in MP4. Die Studio-URL nur bei der Übergabe preisgeben – sie ist die finale, stabile Vorschau; die Screenshots der Bauphase sind headless, zeige also keine Vorschau während des Bauens.

Liefere etwas, auf das du stolz bist. Frage dich vor der Übergabe: Würde ich das in den sozialen Medien mit meinem Namen veröffentlichen? Wenn nicht, behebe, was falsch ist.

Tor: npx hyperframes lint und npx hyperframes validate bestehen ohne Fehler, und die endgültige Antwort enthält die aktive Studio-Projekt-URL.


Kurzreferenz

Videotypen

Typische Einschränkungen nach Videotyp – als Ausgangspunkt, nicht als Formel. Die Beat-Anzahl sollte sich aus dem Inhalt und der Erzählung ergeben, nicht aus einem Zielbereich.

TypTypische DauerDauer-TreiberErzählung
Social-Anzeige (IG/TikTok)10–15sPlattformlimitOptional
Produktdemo30–60sSkriptlängeVollständige Erzählung
Feature-Ankündigung15–30sFeature-KomplexitätVollständige Erzählung
Brand-Reel20–45sMusiktitelOptional, Musikfokus
Launch-Teaser10–20sHook-EnergieMinimal

Die Beat-Anzahl befindet sich nicht absichtlich in dieser Tabelle – sie sollte aus dem Storyboard stammen, nicht aus „Social-Anzeige = 3-4 Beats“. Eine Social-Anzeige für ein komplexes Produkt könnte 5 gut getaktete Beats benötigen. Ein Brand-Reel mit einer starken visuellen These könnte 3 benötigen.

Format

  • Querformat: 1920x1080 (Standard)
  • Hochformat: 1080x1920 (Instagram Stories, TikTok)
  • Quadratisch: 1080x1080 (Instagram-Feed)

Referenzdateien

DateiWann lesen
step-0-capture.mdSchritt 0 – erfassen, Marke und Produkt verstehen, strategieorientierte Site-Zusammenfassung schreiben
step-1-design.mdSchritt 1 – DESIGN.md-Marken-Spickzettel schreiben (5 Abschnitte, 250-350 Zeilen; 50-zeiliger Schnellpfad für Billboard-Social-Anzeigen)
step-2-brief.mdSchritt 2 – Botschaft, narrativen Bogen, Zielgruppe mit dem Benutzer abstimmen
capabilities.mdSchritte 2 & 5 – vollständiges Inventar der HyperFrames-Fähigkeiten (24 Abschnitte). Scanne das Inhaltsverzeichnis während des Briefings, tauche während des Bauens in bestimmte Abschnitte ein
step-3-storyboard.mdSchritt 3 – Storyboard + Drehbuch (kombiniert) mit Benutzer-Review-Tor
step-4-vo.mdSchritt 4 – TTS-Anbieterauswahl, Generierung, Timing
step-5-build.mdSchritt 5 – index.html + Kompositionen erstellen
step-6-validate.mdSchritt 6 – linten, validieren, Screenshots (skaliert auf Videolänge), Vorschau
techniques.mdSchritte 3 & 5 – 13 primitive Animationstechniken mit Code-Mustern (anpassen, nicht kopieren-einfügen)
html-in-canvas-patterns.mdSchritt 5 – vollständige Code-Muster für HTML-in-Canvas-Effekte (befindet sich im hyperframes-Skill)

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 wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

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.

Verwandte Skills