Communitygithub.com

Army161/OpenMontage

短い、デザイン主導のモーショングラフィックを作成します。モーション自体がメッセージとなる、キネティックタイポグラフィ、統計や数字のカウントアップ、チャート/データビジュアライゼーションの演出、ロゴスティング、ブランドロックアップ、ローワーサード、コールアウト、ソーシャルオーバーレイ、アニメーション化されたヘッドライン/ツイート/ニュースアイテム、モーションポスター、またはキャプチャしたページのハイライトなどに使用します。通常10秒未満、最大約30秒で、ナレーションやナレーションアーク、実写被写体はありません。MP4または透明オーバーレイとしてレンダリング可能です。

OpenMontage とは?

Army161/OpenMontageは、短くデザイン重視のモーショングラフィックを専門に作成するAIエージェントスキルです。Claude Code、Cline、またはOpenAI Codex CLIなどのコーディングエージェント環境で動作し、「モーションがメッセージ」であるキネティックタイポグラフィ、カウントアップ、チャートアニメーション、ロゴリビール、ローワーサードなどの作品を生成します。このスキルは、アセット先行のワークフローを採用し、実際の素材を調達してからショットをデザインし、再利用可能なカタログブロックとHyperframesモーションエンジンを活用して構成します。MP4またはWebM/MOVの透明オーバーレイを出力します。ただし、長尺のナレーション動画、ナレーション付きウェブサイト動画、商品プロモーション、トピック解説、既存映像への字幕追加などには対応していません。それらの場合は、それぞれ専用のスキル(general-video、website-to-video、product-launch-video、faceless-explainer、embedded-captions)を使用する必要があります。短いモーション重視の作品か、長いナレーション付きの作品か判断に迷う場合は、まず /hyperframes を参照してください。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

motion-graphics — ディスパッチエントリ

ルートを確認してから Step 0 に進んでください。 このスキルは、短く、デザイン主導で、ナレーションのないモーショングラフィック(モーションがメッセージ、約10秒未満、ボイスオーバーなし)を作成します。より長く、マルチシーン、またはナレーションがある作品 → /general-video;ウェブサイトのナレーション動画 → /website-to-video;トピック解説 → /faceless-explainer;商品プロモーション → /product-launch-video;既存映像への字幕追加 → /embedded-captions。対象外: ライブ/レンダリング時のデータ、またはキャプチャできない映像。モーション重視かナレーションありか不明な場合? まず /hyperframes を読んでください。

デザイン主導の短いモーショングラフィックです。アセットファースト: ショットをデザインする前にアセット戦略を決定し、実際の素材を入手してから、入手した素材に基づいてショットをデザインし、カタログ機能を再利用して構成します。すべてのアーティファクトは PROJECT_DIR = videos/<project-name>/ に配置され(Step 0 で作成)、以下のすべてのパスはこれに対する相対パスです。

フェーズ実行方法主要なアーティファクト詳細フロー
initBashhyperframes.jsonStep 0
planサブエージェント — 検索するかどうかの判断 + 分類 + アセット戦略shot-plan.json(下書き:カテゴリ、asset_needs クエリ、概要)agents/director.md (パート1)
source ◇Bash — media-use resolve (asset_needs が空の場合はスキップ)assets/ + assets/index.mdphases/source/guide.md
designサブエージェント — 解決済みアセットを中心にショットをデザインshot-plan.json(最終版:block(s) + レイアウト + モーション + 位置)agents/director.md (パート2)
buildサブエージェント — 再利用ファーストで構成compositions/index.htmlagents/builder.md
renderBash — hyperframes render (MP4、またはオーバーレイ用に --format webm/mov)renders/video.mp4Step 5
verifyBash — lint / inspect -> 失敗時に修復サブエージェント(その場で修正)agents/finalize.md

◇ source は、選択されたカテゴリがアセットを宣言している場合にのみ実行されます。純粋なコード/テキストカテゴリ(例: kinetic-type、ほとんどの charts/stat)は asset_needs: [] を持ち、計画からデザインに直接スキップします。

カテゴリ — 検索判断による分割

plan の最初の判断は: 検索が必要かどうか? この分岐によりカテゴリは2つのグループに分けられます。その後、検索駆動グループでは検索が返すコンテンツの種類によって特定のカテゴリが選択されます。各カテゴリは categories/<id>/module.md(その計画+ビルドルール)です。共有モーション語彙は references/motion-vocabulary.md にあります(→ hyperframes-animation ルール/ブループリント + レジストリブロック)。

フォームカテゴリ — 検索なし。ユーザーがコンテンツを提供:

カテゴリ意図依存するもの
kinetic-typeインパクトのある行/引用/タイトル、モーションファーストテキストcaption-* ブロック + アニメーションルール
stat単一のヒーロー数字/カウントアップ + リングapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
charts棒/折れ線/円/レース/データからの%data-chart ブロック
logo-revealロゴスティング/ブランドロックアップ(ユーザーロゴ)logo-outro / rules/svg-path-draw
lower-thirds名前/タイトルバー、コールアウト、ソーシャルオーバーレイcaption-* + レジストリオーバーレイブロック

検索駆動カテゴリ — まず検索し、コンテンツタイプでアニメーション化(RWAパス):

返されるコンテンツカテゴリアニメーション
ウェブページ/リンクwebpageウェブページ/UIアニメーション(スクロール、リビール、カーソル、コールアウト)
ニュース記事newsヘッドラインリビール + ソースカード + キーファクトコールアウト
ツイートtweetアニメーションツイートカード
画像/エンティティasset-fusionアセットのジオメトリ自体がチャートになる(RWA内蔵融合)

ビルド順序: 一度に1つ、カバレッジファースト(ラフで問題ありません)。kinetic-type はプロトタイプから移植済み。残りも同様に従います。

前提条件

macOS Apple Silicon または Linux x64。システムツール: brew install node ffmpeg。npx hyperframes doctor を一度実行。macOS GPU レンダリング: export PRODUCER_BROWSER_GPU_MODE=hardware。

オプションキー(設定されていない場合のローカルフォールバック)— media-use を介してアセットをソース/生成するカテゴリにのみ必要:

キー用途フォールバック
GEMINI_API_KEY / GOOGLE_API_KEY画像生成(media-use resolve)生成をスキップ/検索のみ
(asset_scout / 検索プロバイダー)webpage/news/tweet + asset-fusion 実アセット検索カテゴリはアセットフリーに劣化

フロー

Step 0 — 初期化

cwd はエージェントワークスペースルートです。すべてのアーティファクトを PROJECT_DIR = videos/<project-name>/ の下に書き込みます。<project-name>: ユーザーが指定したディレクトリを使用し、それ以外の場合は意図から短いケバブケースの名前(<subject>-motion)を使用します。ワークスペースのベース名やタイムスタンプは使用しません。

$PROJECT_DIR/hyperframes.json がない場合のみ:

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

init はインストール済みスキルをGitHub上の最新版と比較し、古いものがあればグローバルセットを更新します。

制約: hyperframes init をワークスペースルートで実行しないでください。PROJECT_DIR 内に別の hyperframes/ をネストしないでください。すべてのBashコマンド(マスター+サブエージェント)は (cd "$PROJECT_DIR" && ...) サブシェルで実行され、裸の cd は使用しません。

Step 1 — 計画(サブエージェント: Director パート1)

1つのサブエージェントをディスパッチします。プロンプト = 完全な agents/director.md + ## Dispatch context(SKILL_DIR / PROJECT_DIR / ユーザーのリクエスト / Schema: <SKILL_DIR>/references/shot-plan-ir.md)。以下の処理を行う必要があります:

  1. 判断: 検索が必要か?(最初の分岐)
    • いいえ → フォームカテゴリ(kinetic-type / stat / charts / logo-reveal / lower-thirds)を選択。コンテンツはユーザー提供。asset_needs: []。
    • はい → asset_needs[] に検索計画を出力(ニュース/ウェブ/ツイート/画像。2極クエリ)。特定の検索駆動カテゴリ(webpage / news / tweet / asset-fusion)は、Step 2で返されたコンテンツタイプによって確認され、Step 3で最終決定されます。
  2. 下書きの shot-plan.json を書き込む(エンベロープ + 選択されたフォームカテゴリ または 検索意図 + asset_needs + 1段落のショット概要)。スキーマ: references/shot-plan-ir.md。

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

Step 2 — ソース ◇(Bash: media-use、条件付き)

shot-plan.json.asset_needs が空でない場合、アセットを解決(検索/生成/フェッチ → 固定のプロジェクトローカルパス + 原価台帳)。詳細は phases/source/guide.md(media-use resolve をラップ。検索駆動カテゴリは news/web/tweet/image 検索を使用)。asset_needs が空の場合は、Step 3 にスキップ。

# 参考—詳細は phases/source/guide.md を参照
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

グレースフルに劣化: 検索/プロバイダーが利用できない場合、カテゴリはアセットフリーにフォールバックします(context.log に記録)。

Step 3 — デザイン(サブエージェント: Director パート2)

サブエージェントをディスパッチ(プロンプト = agents/director.md パート2 + Step 2が実行された場合の解決済み assets/index.md を含むディスパッチコンテキスト + catalog-map.md)。利用可能なアセットを中心にショットをデザイン: カタログブロック + hyperframes-animation ルール/ブループリント、レイアウト、モーション、ビート、および(asset-fusion の場合は)element_positions + スポイターパレットを選択。shot-plan.json を最終決定(content.block + content.customize + カテゴリごとのコンテンツ)。

Step 4 — ビルド(サブエージェント: Builder、再利用ファースト)

サブエージェントをディスパッチ。プロンプト = 完全な agents/builder.md + ディスパッチコンテキスト(shot-plan.json、catalog-map.md、カテゴリの module.md、references/motion-vocabulary.md、references/builder-contract.md)。再利用ファースト: npx hyperframes add <block> + その場でカスタマイズ。ギャップとアセットフュージョン機能のみ手動で記述。HFコントラクトに従った compositions/index.html を出力(一時停止されたGSAPタイムラインを window.__timelines に、class="clip" + 安定したID、tl.seek(0)、決定論的)。

Step 5 — レンダリング(Bash)

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# 透明オーバーレイバリアント: --format webm (または mov)

Step 6 — 検証(Bash → 失敗時に修復サブエージェント)

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

exit 0 → 完了。lint/inspect エラーの場合、修復サブエージェントをディスパッチ(agents/finalize.md: スナップショットQA + 1回のその場修正パス + 再レンダリング)。修復時に固定期間を変更しないでください。

レポート + オプションのプレビュー

最終出力(renders/video.mp4、または .webm / .mov オーバーレイバリアント)+ 持続時間をレポートします。実行中にプレビューを開かないでください。 リクエストがあった場合のみ、レンダリング後に開始して最終ファイルを提供します:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Studio UI; または共有可能なリンク用に `npx hyperframes play`

フラグは hyperframes-cli スキル(references/preview-render.md)にあります。

再開テーブル

状態再開箇所
shot-plan.json なしStep 1(計画)
shot-plan.json に asset_needs あり、assets/ なしStep 2(ソース)
shot-plan.json 最終版、compositions/index.html なしStep 3/4(デザイン+ビルド)
compositions/index.html 存在、renders/video.mp4 なしStep 5(レンダリング)+ Step 6
renders/video.mp4 存在レポート + 停止

設計ノート(メンテナー向け — 実行時はこれを読みません)

  • アセットファーストの根拠: ソーシングは前倒しされ、ショットデザインに情報を提供します(RWAフロー: 分析→検索→レビュー→構成)。検索駆動カテゴリ(webpage/news/tweet)と asset-fusion はどちらも media-use 検索(news/web/tweet/image)に依存しており、これは media-use の文書化された RWA 系統です。
  • 再利用ファースト: エコシステム内での LLM 生成テンプレートの類似物は「カタログブロック + hyperframes-animation ルールを構成する」です。HF の一時停止GSAPタイムラインは、Remotion の useCurrentFrame に相当します。
  • カテゴリモジュール契約: 1つの categories/<id>/module.md(計画+ビルド)、共有の references/motion-vocabulary.md(+ オプションの評価)を共有します。カテゴリの追加 = フォルダをドロップ + その分類子行を agents/director.md に登録 + catalog-map.md に行を追加。フェーズパイプラインは変更されません。
  • ディレクトリ構造:
    videos/<project-name>/
      hyperframes.json  context.log
      shot-plan.json            # IR(Director 出力)
      assets/  assets/index.md  # media-use 出力(ソースされた場合)
      compositions/index.html   # Builder 出力
      renders/video.mp4
    
  • 登録: hyperframes ルーター内 — 「デザイン主導の短いモーショングラフィック」意図 + ワークフロー説明を追加。/general-video から motion-graphics トリガーを切り出す。逆の使用禁止エッジを追加。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.

関連スキル