Communitygithub.com

Army161/OpenMontage

汎用ウェブサイト/URLをキャプチャし、HyperFramesビデオ(サイトツアー、ショーケース、サイトのビジュアルを使ったソーシャルクリップ)に変換します。ヘッドレスChromeのスクリーンショットとブランドアセットを使用します。ポートフォリオ、ブログ、ランディングページのショーケースや、サイトからのソーシャルクリップに最適です。

OpenMontage とは?

このスキルは、与えられたウェブサイトのURLからプロフェッショナルな動画を生成するためのものです。主に、ポートフォリオ、ブログ、ランディングページなどの汎用的なサイトを、サイトツアーやソーシャルメディアクリップとして紹介する用途に適しています。製品のローンチやプロモーション、GitHub PRの解説、トピック解説、既存動画の編集など、明確に異なる目的を持つユースケースは対象外であり、適切な別スキルへ誘導するルーティング機構を持っています。 このスキルはClaude Code上で動作し、**7つのステップ**からなる協調的なワークフローを提供します。各ステップには成果物(アーティファクト)が紐づいており、それが次のステップへのゲート(関門)となります。ユーザーは各ゲートで承認または指示を行うことで進行しますが、ユーザーが「自律モード」を選択した場合、TTSプロバイダや声、音楽の有無といったユーザー設定に関するゲートはスキップされます。ただし、アセット監査、HTMLの確認、DoDチェックなどの品質検証ゲートは自律モードでもスキップされません。 ワークフローは、まずサイトをキャプチャしてブランドを理解し、次にデザインルールと戦略を定義、ストーリーボードとスクリプトを作成、音声を生成し、最後にビデオをビルドして検証・納品します。各ステップには詳細なリファレンスドキュメントが用意されており、エージェントはそれを読み込んで実行します。最終的には、ローカルで動作するStudioプロジェクトのURLが成果物として提供され、ユーザーが明示的に要求した場合のみMP4にレンダリングされます。

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

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

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

ドキュメント

media-use: オーディオ/画像のソーシングの前に、/media-useを呼び出してHeyGenカタログからBGM/効果音/画像を取得します。既存のアセットを登録するには、最初に--adoptを実行してください。詳細は/media-useスキルを参照してください。

ウェブサイトからHyperFramesへ

ウェブサイトをキャプチャし、そこからプロフェッショナルなビデオを生成します。

ステップ0の前にルートを確認してください。 このスキルは、汎用的なサイトの / からの ビデオを作成します。ユーザーが実際に製品をマーケティング / ローンチ / プロモーションしている場合(このURLからの場合でも、「自社サイトのプロモーション」の場合でも)→ /product-launch-video。サイトのないトピック解説 → /faceless-explainer; GitHub PR → /pr-to-video; 既存のビデオファイルの再編集 / 再着色 / 再順序付け → 対象外。漠然と「ビデオを作って」と指示されてここにルーティングされた場合、またはローンチか汎用サイトか不明な場合? 最初に/hyperframesを読んでください(完全なルーティングテーブル + § HyperFramesでできないこと)。

ユーザーは次のように言います:

  • 「このウェブサイトをInstagram用の15秒のソーシャルクリップに変換して」
  • 「https://... から30秒のサイトツアー/ショーケースを作って」
  • 「私たちのホームページをキャプチャして、そのビジュアルからビデオを構築して」

このワークフローには7つのステップがあります。各ステップは次のステップへのゲートとなるアーティファクトを生成します。デフォルトでは協調的で、💬 で示されたゲートは停止してユーザーに尋ねます。ユーザーが自律モード(「代わりに決めて」、「驚かせて」)を指示した場合、💬 のユーザー設定ゲートはスキップされます。その伝播方法については step-2-brief.md を参照してください。

自律モードは「すべてのゲートをスキップする」ことではありません。 自動モードはユーザー設定に関する質問(TTSプロバイダ、声、色の強調、ビート数、音楽の有無、キャプションの有無など、エージェントがユーザーに代わって決定するもの)をカバーします。品質検証ゲートはカバーしません。以下のものは自動モードでもスキップできません:

  • アセット監査(ステップ3) — コンタクトシートを表示し、各アセットのUSE/SKIPを正当化する
  • ビートごとのHTML読み取り(ステップ5) — ビートごとの構造化エビデンスブロック
  • DoDチェックリスト(ステップ6) — アニメーションマップ、警告ごとのWCAG検証、オーディオ/モーション再生を含む
  • 正直な開示セクション(ステップ6) — 「私が検証しなかったこと」が最終サマリーに含まれなければならない

もし「自動モードは行動へのバイアスをかけるから、Xをスキップしよう」と推論している場合、そしてXが設定の質問ではなく検証ゲートである場合、その推論は間違っています。行動へのバイアスは_何を構築するか_の決定に適用され、_検証するかどうか_の決定には適用されません。


ステップ0: キャプチャとブランドの理解

読む: references/step-0-capture.md

サイトをキャプチャし、抽出されたデータを読んでブランドと製品を理解します — 何をするものか、誰のためのものか、どのような声で話すか、どのような雰囲気の中に存在するか。キャプチャされたアセットは後で使用するブランドツールキットであり、ビデオを構成する構成要素ではありません。

ブリーフの前にサインインステータスを表示 — npx hyperframes auth status を実行し、その出力をそのまま伝えます(言い換えたり書き換えたりしないでください)。 これにより、ボイス/BGMがHeyGenとローカルエンジンのどちらを使用するか、またサインインしていない場合のサインイン方法が報告されます。サインインしていない場合は、ブリーフやその他を尋ねる前に停止し、ユーザーが選択するのを待ちます — サインインするか、「go」/「offline」と言ってローカルエンジンを続行するか。 これは単なる通過点ではなく、実際の決定ポイントとして扱います。選択をブリーフの質問に折り込んだり、リポジトリごとの .env にキーを書き込んだりしないでください。(自律モードでは、ステータスを記録し、オフラインで続行します。)標準的なガイダンスについては ../hyperframes-media → Preflight を参照してください。

ゲート: サイトサマリーが印刷されている — アセット/カラー/フォントのインベントリよりも先に、戦略ファーストで(製品が何をするか、誰のためのものか、ブランドボイス);サインインステータスが表示されている(サインインしている、またはオフラインで続行)。


ステップ1: ブランドアイデンティティ

読む: references/step-1-design.md

DESIGN.mdを書く — 視覚的アイデンティティをカバーするブランドのチートシート:色、タイポグラフィ、コンポーネントスタイル、レイアウトの原則。正確な計算値には design-styles.json を使用します。

速度オプション: 高速なビデオ(ビルボードごとのビート)の場合、DESIGN.mdは50行のカラー+フォント+Do's/Don'tsのサマリーでよく、300行のドキュメントは必要ありません。ステップ5のサブエージェントプロンプトはブランド値を直接貼り付けるため、DESIGN.mdの深さは複雑なコンポジションに対してのみ重要です。

ゲート: DESIGN.md が存在する(任意の長さで)最低限:カラーパレット、フォントの選択、Do's/Don'ts。


ステップ2: 戦略とメッセージング

読む: references/step-2-brief.md, references/capabilities.md(目次をざっと見る — 必要に応じて詳細セクションに深く入り込む)

ビジュアルやアセットの話に入る前に、ビデオが何を伝えるべきかについてユーザーと調整します。ユーザーのプロンプトを解析します — おそらくすでにビデオのタイプとスタイルが与えられているでしょう。不足しているものだけを尋ねます:このビデオが伝えるべき唯一のこと、ナラティブアーク、およびオーディエンス。

ゲート: ビデオタイプ、長さ、フォーマット、そして重要なことに、メッセージとナラティブアークがロックされている。これらがなければ、ステップ3はコンセプトファーストのストーリーボードを書くことができません。


ステップ3: ストーリーボード + スクリプト 💬

読む: references/step-3-storyboard.md

ストーリーボードをコンセプトファーストで書く:メッセージ → ナラティブアーク → アークに奉仕するビート → ビートごとのテクニック → 最後にブランドアクセントのパス。次にナレーションスクリプトをそれに合わせて書く。両方をビートごとのサマリーとともにユーザーに提示する。ユーザーが承認するまで繰り返す。

ゲート: STORYBOARD.md + SCRIPT.md が存在し、かつユーザーが計画を承認している。


ステップ4: VO、タイミング + キャプション 💬

読む: references/step-4-vo.md

ステップ2でナレーションなしと言われた場合 — 背景音楽について尋ね、ステップ5にスキップします。そうでない場合:どのTTSプロバイダを使用するかユーザーに尋ね(HeyGen TTS、ElevenLabs、またはKokoro)、音声を生成し、文字起こしし、タイムスタンプをビートにマッピングします。次にキャプションについて尋ねます。

ゲート: (a) ナレーションが要求されておらず、ストーリーボードに手動のビートタイミングがある、または (b) narration.wav + transcript.json が存在し、ビートタイミングが実際の長さで更新されている。


ステップ5: コンポジションの構築

読む: hyperframes スキル(ロードすること — すべてのルールが重要) 読む: references/step-5-build.md

ストーリーボード(ステップ3)で選択されたアーキテクチャとペーシングに従って、index.html とコンポジションを構築します。サブエージェントは、報告する前に各ビートで hyperframes lint と hyperframes snapshot を実行します。

ゲート: すべての compositions/beat-N.html がメインエージェントによって DESIGN.md と STORYBOARD.md に対して上から下まで読まれている。ビートごとのチェックリストは step-5-build.md にあります。


ステップ6: 検証と納品

読む: references/step-6-validate.md

Lint、検証、ビデオ長にスケーリングされたスナップショット(計算式:max(beats × 3, ceil(duration_seconds / 2)))を取得し、それぞれをレビューします。納品前に問題を修正します。localhostのStudioプロジェクトURLを納品します — MP4へのレンダリングはユーザーの明示的な要求があった場合のみ行います。そのStudio URLはハンドオフ時のみ表面化させます — これは最終的で安定したプレビューです;ビルドフェーズのスナップショットはヘッドレスであるため、ビルド中にプレビューをポップアップさせないでください。

誇りに思えるものを納品してください。 ハンドオフする前に、自問してください:これを自分の名前でソーシャルメディアに投稿しますか? もしそうでなければ、問題を修正してください。

ゲート: npx hyperframes lint と npx hyperframes validate がエラーゼロでパスし、最終レスポンスにアクティブなStudioプロジェクトURLが含まれている。


クイックリファレンス

ビデオタイプ

ビデオタイプごとの典型的な制約 — 公式としてではなく、出発点として使用します。ビート数は、目標範囲からではなく、コンテンツとナレーションに従うべきです。

タイプ典型的な長さ長さの決定要因ナレーション
ソーシャル広告(IG/TikTok)10–15秒プラットフォーム制限オプション
プロダクトデモ30–60秒スクリプトの長さフルナレーション
機能発表15–30秒機能の複雑さフルナレーション
ブランドリール20–45秒音楽トラックオプション、音楽重視
ローンチティーザー10–20秒フックのエネルギー最小限

ビート数は意図的にこの表に含まれていません — 「ソーシャル広告 = 3〜4ビート」からではなく、ストーリーボードから導き出すべきです。複雑な製品のソーシャル広告には、タイミングの良い5つのビートが必要かもしれません。1つの強力なビジュアルテーゼを持つブランドリールには、3つのビートで十分かもしれません。

フォーマット

  • ランドスケープ: 1920x1080(デフォルト)
  • ポートレート: 1080x1920(Instagramストーリーズ、TikTok)
  • スクエア: 1080x1080(Instagramフィード)

リファレンスファイル

ファイルいつ読むか
step-0-capture.mdステップ0 — キャプチャ、ブランドと製品を理解し、戦略ファーストのサイトサマリーを書く
step-1-design.mdステップ1 — DESIGN.mdブランドチートシートを書く(5セクション、250-350行;ビルボードスタイルのソーシャル広告用50行の高速パス)
step-2-brief.mdステップ2 — メッセージ、ナラティブアーク、オーディエンスをユーザーと調整する
capabilities.mdステップ2 & 5 — HyperFramesができることの完全なインベントリ(24セクション)。ブリーフ中に目次をざっと見て、ビルド中に特定のセクションを深掘りする
step-3-storyboard.mdステップ3 — ストーリーボード + スクリプト(結合版)、ユーザーレビューゲート付き
step-4-vo.mdステップ4 — TTSプロバイダの選択、生成、タイミング
step-5-build.mdステップ5 — index.html + コンポジションを構築する
step-6-validate.mdステップ6 — lint、検証、スナップショット(ビデオ長にスケーリング)、プレビュー
techniques.mdステップ3 & 5 — コードパターンを備えた13のプリミティブアニメーションテクニック(コピーペーストせずに適応する)
html-in-canvas-patterns.mdステップ5 — HTML-in-Canvasエフェクトの完全なコードパターン(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.

関連スキル