Communitygithub.com

Army161/OpenMontage

Utilisez cette compétence lorsque l'utilisateur souhaite un court-métrage graphique animé, guidé par le design, où le mouvement est le message : typographie cinétique, compteur de statistiques ou de nombres, animation de graphiques/données, logo sting, habillage de marque, tiers inférieur, callout, overlay social, titre animé/tweet/actualité, affiche animée ou mise en évidence rapide d'une page capturée. Généralement moins de 10 secondes et jusqu'à ~30 secondes, sans arc narratif, voix off ou sujet en prise de vue réelle. Peut être rendu en MP4 ou en overlay transparent. Ne convient pas pour les pièces plus longues, multi-scènes, narrées ou les reels de marque (utilisez general-video), les vidéos de sites web narrées (website-to-video), les explications de sujet (faceless-explainer), les promotions de produits (product-launch-video), les vidéos RP (pr-to-video), ou les légendes sur des images existantes (embedded-captions). En cas de doute entre un court-métrage rapide axé sur le mouvement et un traitement plus long ou narré, consultez /hyperframes.

Qu'est-ce que OpenMontage ?

Cette compétence est un générateur de courts-métrages graphiques animés, conçu pour les créateurs de contenu et les développeurs qui ont besoin de produire rapidement des animations percutantes et visuellement soignées. Elle excelle dans la création de contenus comme la typographie cinétique, les compteurs de statistiques, les animations de graphiques, les logos animés, les tiers inférieurs et les overlays sociaux, le tout en moins de 30 secondes et sans voix off. La compétence suit un flux de travail piloté par les assets : elle commence par définir une stratégie d'assets, puis recherche ou génère le contenu nécessaire avant de concevoir la composition autour de ce matériel. Ce processus est géré par des sous-agents spécialisés (Director, Builder) qui orchestrent la planification, le design, la construction (en réutilisant des blocs de catalogue) et le rendu final via l'outil `hyperframes`. Fonctionnant sur macOS Apple Silicon et Linux x64, elle nécessite Node.js et FFmpeg. Les résultats sont rendus au format MP4 ou en overlay transparent (WebM/MOV). En résumé, c'est l'outil idéal pour transformer rapidement une idée de motion design courte et sans narration en une animation prête à l'emploi.

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

Demander à votre IA préférée

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

Documentation

motion-graphics — point d'entrée de dispatch

Confirmez la route avant l'étape 0. Cette compétence réalise une courte animation graphique, guidée par le design, sans narration (le mouvement est le message ; ~moins de 10s, pas de voix off). Un traitement plus long, multi-scènes ou narré → /general-video ; une vidéo narrée d'un site web → /website-to-video ; une explication de sujet → /faceless-explainer ; une promotion de produit → /product-launch-video ; des légendes sur des images existantes → /embedded-captions. Hors scope : données en direct / au moment du rendu, ou séquences impossibles à capturer. Pas sûr qu'il s'agisse d'un motion-first ou d'un narré ? Lisez /hyperframes d'abord.

Une courte animation graphique guidée par le design. Priorité aux assets : décidez de la stratégie d'assets et sourcez du matériel réel avant de concevoir le plan, puis concevez le plan autour de ce que vous avez, et enfin composez en réutilisant les capacités du catalogue. Tous les artefacts vont dans PROJECT_DIR = videos/<nom-du-projet>/ (créé à l'étape 0) ; tous les chemins ci-dessous sont relatifs à ce répertoire.

PhaseExécutionArtefact principalFlux détaillé
initBashhyperframes.jsonÉtape 0
plansous-agent — décider de la recherche ? + classifier + stratégie d'assetsshot-plan.json (brouillon : catégorie, requêtes asset_needs, brief)agents/director.md (Partie 1)
source ◇Bash — résolution media-use (ignorer si asset_needs est vide)assets/ + assets/index.mdphases/source/guide.md
designsous-agent — conception du plan autour des assets résolusshot-plan.json (final : bloc(s) + disposition + mouvement + positions)agents/director.md (Partie 2)
buildsous-agent — composition en priorisant la réutilisationcompositions/index.htmlagents/builder.md
renderBash — hyperframes render (MP4, ou --format webm/mov pour overlay)renders/video.mp4Étape 5
verifyBash — lint / inspect -> sous-agent de réparation en cas d'échec(corrections sur place)agents/finalize.md

◇ source ne s'exécute que lorsque la catégorie choisie déclare des assets. Les catégories purement textuelles/code (par ex. kinetic-type, la plupart des charts/stat) ont asset_needs: [] et passent directement de la planification à la conception.

Catégories — divisées par la décision de recherche

La première décision de plan est : cela nécessite-t-il une recherche ? Cette bifurcation sépare les catégories en deux groupes ; ensuite, la catégorie spécifique est choisie — pour les catégories pilotées par la recherche, par le type de contenu retourné par la recherche. Chaque catégorie est un categories/<id>/module.md (ses règles de planification + construction) ; le vocabulaire de mouvement partagé se trouve dans references/motion-vocabulary.md (→ règles/plans hyperframes-animation + blocs de registre).

Catégories de formulaire — pas de recherche ; l'utilisateur fournit le contenu :

CatégorieIntentionRepose sur
kinetic-typeligne / citation / titre percutant, texte avec mouvementblocs caption-* + règles d'animation
statchiffre unique / compte à rebours + anneauapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsbarres / lignes / camembert / course / % à partir de donnéesbloc data-chart
logo-reveallogo sting / habillage de marque (logo utilisateur)logo-outro / rules/svg-path-draw
lower-thirdsbarres de nom / titre, callouts, overlays sociauxcaption-* + blocs d'overlay du registre

Catégories pilotées par la recherche — rechercher d'abord, puis animer par type de contenu (le chemin RWA) :

Contenu retournéCatégorieAnimation
page web / lienwebpageanimation de page web / UI (défilement, révélation, curseur, callouts)
article de pressenewsrévélation du titre + carte source + callouts de faits clés
tweettweetcarte tweet animée
image / entitéasset-fusionla géométrie de l'asset devient le graphique (fusion diégétique RWA)

Ordre de construction : un à la fois, priorité à la couverture (l'ébauche est acceptable). kinetic-type portée du prototype ; les autres suivent.

Prérequis

macOS Apple Silicon ou Linux x64. Outils système : brew install node ffmpeg. npx hyperframes doctor une fois. Rendu GPU macOS : export PRODUCER_BROWSER_GPU_MODE=hardware.

Clés optionnelles (fallbacks locaux si non définies) — nécessaires uniquement pour les catégories qui sourcent/génèrent des assets via media-use :

CléUtilisé pourFallback
GEMINI_API_KEY / GOOGLE_API_KEYgénération d'image (résolution media-use)ignorer la génération / recherche seule
(fournisseurs asset_scout / recherche)recherche d'assets réels pour webpage/news/tweet + asset-fusionla catégorie se dégrade en version sans asset

Flux

Étape 0 — Initialisation

cwd est la racine de l'espace de travail de l'agent ; écrivez tous les artefacts sous PROJECT_DIR = videos/<nom-du-projet>/. <nom-du-projet> : utilisez le répertoire donné par l'utilisateur, sinon un nom court en kebab-case dérivé de l'intention (<sujet>-motion). Pas le nom de base de l'espace de travail ni un horodatage.

Uniquement lorsque $PROJECT_DIR/hyperframes.json est absent :

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<nom-du-projet>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank

init vérifie les compétences installées par rapport aux dernières sur GitHub et met à jour l'ensemble global si certaines sont obsolètes.

Contraintes : ne jamais hyperframes init dans la racine de l'espace de travail ; ne jamais imbriquer un autre hyperframes/ à l'intérieur de PROJECT_DIR ; chaque commande Bash (maître + sous-agents) est un sous-shell (cd "$PROJECT_DIR" && ...) — jamais de cd nu.

Étape 1 — Planification (sous-agent : Directeur Partie 1)

Dispatch d'un sous-agent. prompt = agents/director.md complet + ## Contexte de dispatch (SKILL_DIR / PROJECT_DIR / la demande de l'utilisateur / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Il doit :

  1. Décider : cela nécessite-t-il une recherche ? (la première bifurcation)
    • Non → choisir une catégorie de formulaire (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ; asset_needs: [].
    • Oui → émettre un plan de recherche dans asset_needs[] (actualités / web / tweet / image ; requêtes bipolaires). La catégorie pilotée par la recherche spécifique (webpage / news / tweet / asset-fusion) est confirmée par le type de contenu retourné à l'étape 2, et finalisée à l'étape 3.
  2. Écrire un brouillon shot-plan.json (enveloppe + catégorie de formulaire choisie ou intention de recherche + asset_needs + un brief de plan d'un paragraphe). Schéma : references/shot-plan-ir.md.

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

Étape 2 — Source ◇ (Bash : media-use, conditionnel)

Si shot-plan.json.asset_needs n'est pas vide, résoudre les assets (recherche / génération / récupération → chemins locaux figés dans le projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories pilotées par la recherche utilisent la recherche d'actualités/web/tweet/image). Si asset_needs est vide, passer à l'étape 3.

# illustratif — voir phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

Dégradation gracieuse : si un fournisseur de recherche est indisponible, la catégorie revient à une version sans asset (notez-le dans context.log).

Étape 3 — Conception (sous-agent : Directeur Partie 2)

Dispatch d'un sous-agent (prompt = agents/director.md Partie 2 + contexte de dispatch incluant le assets/index.md résolu si l'étape 2 a été exécutée + catalog-map.md). Il conçoit le plan autour des assets disponibles : choisir le(s) bloc(s) de catalogue + les règles/plans hyperframes-animation, la disposition, le mouvement, les beats, et (pour asset-fusion) les element_positions + la palette de la pipette. Finalise shot-plan.json (content.block + content.customize + contenu par catégorie).

Étape 4 — Construction (sous-agent : Builder, priorité à la réutilisation)

Dispatch d'un sous-agent. prompt = agents/builder.md complet + contexte de dispatch (shot-plan.json, catalog-map.md, le module.md de la catégorie, references/motion-vocabulary.md, references/builder-contract.md). Priorité à la réutilisation : npx hyperframes add <block> + personnalisation sur place ; n'écrivez à la main que les lacunes + l'affordance de fusion d'assets. Sortie compositions/index.html respectant le contrat HF (timeline GSAP en pause sur window.__timelines, class="clip" + ids stables, tl.seek(0), déterministe).

Étape 5 — Rendu (Bash)

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# variante overlay transparent : --format webm  (ou mov)

Étape 6 — Vérification (Bash → sous-agent de réparation en cas d'échec)

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

exit 0 → terminé. En cas d'erreurs de lint/inspect, dispatcher le sous-agent de réparation (agents/finalize.md : QA instantané + un passage de correction sur place + nouveau rendu). Ne jamais modifier une durée fixe lors de la réparation.

Rapport + aperçu optionnel

Signaler la sortie finale (renders/video.mp4, ou la variante .webm / .mov pour overlay) + durée. Ne pas ouvrir d'aperçu pendant l'exécution. N'en proposer un que sur demande, démarré après le rendu afin qu'il serve le fichier final :

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Interface Studio ; ou `npx hyperframes play` pour un lien partageable

Les indicateurs se trouvent dans la compétence hyperframes-cli (references/preview-render.md).

Tableau de reprise

ÉtatReprendre à partir de
pas de shot-plan.jsonÉtape 1 (planification)
shot-plan.json a asset_needs, pas de assets/Étape 2 (source)
shot-plan.json final, pas de compositions/index.htmlÉtape 3/4 (conception+construction)
compositions/index.html existe, pas de renders/video.mp4Étape 5 (rendu) + Étape 6
renders/video.mp4 existeRapport + arrêt

Notes de conception (mainteneurs — l'exécution ne lit pas ceci)

  • Justification de la priorité aux assets : le sourcing est mis en avant et informe la conception du plan (le flux RWA : analyser → rechercher → examiner → composer). Les catégories pilotées par la recherche (webpage/news/tweet) et asset-fusion s'appuient toutes deux sur la recherche media-use (actualités/web/tweet/image), qui est la lignée RWA documentée de media-use.
  • Priorité à la réutilisation : l'analogue intra-écosystème des modèles générés par LLM est « composer des blocs de catalogue + règles hyperframes-animation ». La timeline GSAP en pause de HF ≙ le useCurrentFrame de Remotion.
  • Contrat du module de catégorie : un categories/<id>/module.md (planification + construction), partageant references/motion-vocabulary.md (+ évaluation optionnelle). Ajouter une catégorie = déposer le dossier + enregistrer sa ligne de classifieur dans agents/director.md + sa ligne dans catalog-map.md ; le pipeline de phases est inchangé.
  • Structure du répertoire :
    videos/<nom-du-projet>/
      hyperframes.json  context.log
      shot-plan.json            # le RI (sortie du Directeur)
      assets/  assets/index.md  # sortie de media-use (si sourcé)
      compositions/index.html   # sortie du Builder
      renders/video.mp4
    
  • Enregistrement : dans le routeur hyperframes — ajouter l'intention « courte animation graphique guidée par le design » + description du Workflow ; extraire les déclencheurs de motion-graphics de /general-video ; ajouter les arêtes inverses « NE PAS UTILISER ». Voir 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.

Skills associés