Communitygithub.com

Army161/OpenMontage

Capturez un site Web / une URL et transformez-le en vidéo HyperFrames (visite de site, démonstration ou clip social à partir des visuels du site). Utilise Chrome headless pour les captures d'écran et les assets de marque. À utiliser lorsque l'intention est générale — portfolio, blog, page d'accueil ou clip social à partir du site.

Qu'est-ce que OpenMontage ?

Ce skill permet de capturer un site Web général (portfolio, blog, landing page) et de le transformer en une vidéo professionnelle de type HyperFrames — visite de site, démonstration ou clip social — en utilisant les propres visuels du site. Il repose sur un workflow collaboratif en 7 étapes, allant de la capture du site et de l'analyse de la marque jusqu'à la validation et la livraison de la vidéo. Le skill intègre des mécanismes de vérification de qualité (audit des assets, lecture HTML par beat, checklist de définition de fait) qui restent obligatoires même en mode autonome. Il prend en charge les agents comme Claude Code, Cursor ou Codex, et s'appuie sur l'outil HyperFrames avec la bibliothèque HeyGen pour les ressources audio et visuelles. Contrairement à d'autres skills dédiés au lancement de produit ou aux explainers, celui-ci est conçu pour les cas généraux où l'utilisateur souhaite simplement mettre en valeur un site existant.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

media-use : Avant de sourcer l'audio/les images, appelez /media-use pour résoudre BGM/SFX/images depuis le catalogue HeyGen. Exécutez --adopt d'abord pour enregistrer les assets existants. Voir le skill /media-use.

Site Web vers HyperFrames

Capturez un site Web, puis produisez une vidéo professionnelle à partir de celui-ci.

Confirmez la route avant l'étape 0. Ce skill crée une vidéo d'un / à partir d'un site général. Si l'utilisateur fait vraiment du marketing / lancement / promotion d'un produit (même à partir de cette URL, même "promo pour notre site") → /product-launch-video. Un explicateur de sujet sans site → /faceless-explainer ; une PR GitHub → /pr-to-video ; recouper / recolorier / réorganiser un fichier vidéo existant → hors de portée. Routé ici sur un vague "faire une vidéo", ou incertain entre lancement et site général ? Lisez /hyperframes d'abord (table de routage complète + § Ce que HyperFrames ne peut pas faire).

Les utilisateurs disent des choses comme :

  • "Transforme ce site Web en un clip social de 15 secondes pour Instagram"
  • "Fais une visite de site / démonstration de 30 secondes à partir de https://..."
  • "Capture notre page d'accueil et construis une vidéo à partir de ses propres visuels"

Le workflow comporte 7 étapes. Chacune produit un artefact qui conditionne la suivante. Par défaut, il est collaboratif — les étapes marquées 💬 s'arrêtent et demandent à l'utilisateur. Si l'utilisateur signale un mode autonome ("décide pour moi", "surprends-moi"), les étapes 💬 liées aux préférences utilisateur sont ignorées ; voir step-2-brief.md pour la propagation.

Le mode autonome ne signifie PAS "ignorer toutes les vérifications". Le mode automatique couvre les questions de préférence utilisateur (fournisseur TTS, voix, accent de couleur, nombre de temps, musique oui/non, sous-titres oui/non — où l'agent décide pour l'utilisateur). Il ne couvre PAS les étapes de vérification de qualité. Les éléments suivants restent non ignorables en mode automatique :

  • Audit des assets (Étape 3) — visualisation des planches contact et justification UTILISER/IGNORER pour chaque asset
  • Lecture HTML par temps (Étape 5) — bloc de preuve structuré par temps
  • Checklist DoD (Étape 6) — incluant la carte d'animation, la vérification WCAG par avertissement, la lecture audio/mouvement
  • Section de divulgation honnête (Étape 6) — "Ce que je n'ai PAS vérifié" doit apparaître dans votre résumé final

Si vous vous surprenez à raisonner "le mode automatique dit de privilégier l'action, donc je vais ignorer X" — et que X est une étape de vérification, pas une question de préférence — ce raisonnement est erroné. Privilégier l'action s'applique à décider quoi construire, pas à décider si vérifier.


Étape 0 : Capture et Compréhension de la Marque

Lisez : references/step-0-capture.md

Capturez le site, puis lisez les données extraites pour comprendre la marque et le produit — ce qu'il fait, pour qui, quelle voix il utilise, dans quelle ambiance il évolue. Les assets capturés sont une boîte à outils de marque pour plus tard, pas les éléments de base à partir desquels la vidéo est fabriquée.

Affichez le statut de connexion avant le brief — exécutez npx hyperframes auth status et retransmettez sa sortie textuellement (ne paraphrasez pas et ne réécrivez pas). Il indique si la voix/BGM utilisera HeyGen ou les moteurs locaux et, lorsqu'il n'est pas connecté, comment se connecter. S'il n'est pas connecté, ARRÊTEZ-VOUS et attendez que l'utilisateur choisisse — se connecter, ou dire "go"/"offline" pour continuer avec les moteurs locaux — avant de demander le brief ou quoi que ce soit d'autre. Traitez-le comme un véritable point de décision, pas comme une note de passage ; n'intégrez pas le choix dans la question du brief, et n'écrivez pas les clés dans un .env par dépôt. (En mode autonome, notez le statut et continuez hors ligne.) Voir ../hyperframes-media → Preflight pour les instructions canoniques.

Point de contrôle : Résumé du site imprimé — stratégie d'abord (ce que le produit fait, pour qui, voix de la marque) avant l'inventaire des assets / couleurs / polices ; le statut de connexion a été affiché (connecté, ou continuation hors ligne).


Étape 1 : Identité de Marque

Lisez : references/step-1-design.md

Écrivez DESIGN.md — une fiche de référence de la marque couvrant l'identité visuelle : couleurs, typographie, styles de composants, principes de mise en page. Utilisez design-styles.json pour les valeurs calculées exactes.

Option rapide : Pour les vidéos au rythme rapide (panneau d'affichage par temps), DESIGN.md peut être un résumé de 50 lignes des couleurs + polices + à faire/à ne pas faire — pas un document de 300 lignes. Le prompt du sous-agent à l'Étape 5 colle directement les valeurs de la marque, donc la profondeur de DESIGN.md n'a d'importance que pour les compositions complexes.

Point de contrôle : DESIGN.md existe (quelle que soit la longueur) avec au minimum : palette de couleurs, choix de polices, et à faire/à ne pas faire.


Étape 2 : Stratégie et Messagerie

Lisez : references/step-2-brief.md, references/capabilities.md (parcourez la Table des Matières — sections approfondies uniquement si nécessaire)

Alignez-vous avec l'utilisateur sur ce que la vidéo doit communiquer avant de parler de visuels ou d'assets. Analysez le prompt de l'utilisateur — il vous a probablement déjà donné le type et le style de la vidéo. Ne demandez que ce qui manque : la SEULE chose que cette vidéo doit dire, l'arc narratif, et le public.

Point de contrôle : Le type de vidéo, la durée, le format et — crucialement — le message et l'arc narratif sont verrouillés. Sans cela, l'Étape 3 ne peut pas écrire un storyboard axé sur le concept.


Étape 3 : Storyboard + Script 💬

Lisez : references/step-3-storyboard.md

Écrivez le storyboard concept d'abord : message → arc narratif → temps qui servent l'arc → techniques par temps → touches de marque à la fin. Écrivez ensuite le script de narration correspondant. Présentez les deux à l'utilisateur avec un résumé temps par temps. Itérez jusqu'à approbation.

Point de contrôle : STORYBOARD.md + SCRIPT.md existent ET l'utilisateur a approuvé le plan.


Étape 4 : VO, Timing + Sous-titres 💬

Lisez : references/step-4-vo.md

Si l'Étape 2 a dit pas de narration — demandez pour la musique de fond, puis passez à l'Étape 5. Sinon : demandez à l'utilisateur quel fournisseur TTS (HeyGen TTS, ElevenLabs ou Kokoro), générez l'audio, transcrivez, mappez les horodatages aux temps. Demandez ensuite pour les sous-titres.

Point de contrôle : Soit (a) aucune narration n'a été demandée et le storyboard a des timings de temps manuels, soit (b) narration.wav + transcript.json existent et les timings des temps sont mis à jour avec les durées réelles.


Étape 5 : Construction des Compositions

Lisez : Le skill hyperframes (chargez-le — chaque règle compte) Lisez : references/step-5-build.md

Construisez index.html et les compositions en suivant l'architecture et le rythme choisis dans le storyboard (Étape 3). Les sous-agents exécutent hyperframes lint et hyperframes snapshot sur chaque temps avant de faire leur rapport.

Point de contrôle : Chaque compositions/beat-N.html a été lu de haut en bas par l'agent principal par rapport à DESIGN.md et STORYBOARD.md. La checklist par temps se trouve dans step-5-build.md.


Étape 6 : Valider et Livrer

Lisez : references/step-6-validate.md

Lintez, validez, prenez des instantanés à l'échelle de la longueur de la vidéo (formule : max(temps × 3, ceil(durée_secondes / 2))), et examinez chacun d'eux. Corrigez les problèmes avant de livrer. Livrez l'URL du projet Studio localhost — ne rendez en MP4 que sur demande explicite de l'utilisateur. Présentez cette URL Studio uniquement à la livraison — c'est l'aperçu stable final ; les instantanés de la phase de construction sont sans tête, donc ne faites pas apparaître un aperçu en cours de construction.

Livrez quelque chose dont vous êtes fier. Avant de remettre, demandez-vous : est-ce que je publierais ceci sur les réseaux sociaux avec mon nom ? Si non, corrigez ce qui ne va pas.

Point de contrôle : npx hyperframes lint et npx hyperframes validate passent avec zéro erreur, et la réponse finale inclut l'URL du projet Studio actif.


Référence Rapide

Types de Vidéos

Contraintes typiques par type de vidéo — à utiliser comme point de départ, pas comme formule. Le nombre de temps doit découler du contenu et de la narration, pas d'une plage cible.

TypeDurée typiquePilote de duréeNarration
Publicité sociale (IG/TikTok)10–15sLimite de la plateformeOptionnelle
Démo produit30–60sLongueur du scriptNarration complète
Annonce de fonctionnalité15–30sComplexité de la fonctionnalitéNarration complète
Bande de marque20–45sPiste musicaleOptionnelle, focus musique
Teaser de lancement10–20sÉnergie du crochetMinimale

Le nombre de temps n'est pas intentionnellement dans ce tableau — il doit venir du storyboard, pas de "publicité sociale = 3-4 temps." Une publicité sociale pour un produit complexe pourrait nécessiter 5 temps bien chronométrés. Une bande de marque avec une thèse visuelle forte pourrait n'en nécessiter que 3.

Format

  • Paysage : 1920x1080 (par défaut)
  • Portrait : 1080x1920 (Instagram Stories, TikTok)
  • Carré : 1080x1080 (flux Instagram)

Fichiers de Référence

FichierQuand lire
step-0-capture.mdÉtape 0 — capturer, comprendre la marque et le produit, écrire un résumé du site axé sur la stratégie
step-1-design.mdÉtape 1 — écrire la fiche de référence DESIGN.md de la marque (5 sections, 250-350 lignes ; chemin rapide de 50 lignes pour les publicités sociales de type panneau d'affichage)
step-2-brief.mdÉtape 2 — s'aligner sur le message, l'arc narratif, le public avec l'utilisateur
capabilities.mdÉtapes 2 & 5 — inventaire complet de ce que HyperFrames peut faire (24 sections). Parcourez la TdM pendant le brief, plongez dans les sections spécifiques pendant la construction
step-3-storyboard.mdÉtape 3 — storyboard + script (combiné) avec point de contrôle de révision utilisateur
step-4-vo.mdÉtape 4 — choix du fournisseur TTS, génération, timing
step-5-build.mdÉtape 5 — construire index.html + compositions
step-6-validate.mdÉtape 6 — linter, valider, instantanés (à l'échelle de la longueur de la vidéo), aperçu
techniques.mdÉtapes 3 & 5 — 13 techniques d'animation primitives avec des modèles de code (adaptez, ne copiez-collez pas)
html-in-canvas-patterns.mdÉtape 5 — modèles de code complets pour les effets HTML-dans-Canvas (réside dans le skill hyperframes)

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.

Skills associés