Communitygithub.com

Army161/OpenMontage

將一般網站/網址抓取下來,並轉換成 HyperFrames 影片(網站導覽、展示或來自網站視覺的社交短片)。使用無頭 Chrome 截圖與品牌資產。

OpenMontage 是什麼?

這個技能專門從一個普通的網站網址,自動化產生專業的 HyperFrames 影片。它使用無頭 Chrome 瀏覽器來截取網站畫面,並提取品牌資產(如顏色、字型)作為影片的設計基礎。工作流程分為七個嚴謹的步驟:從品牌與產品理解、設計規範(DESIGN.md)撰寫,到敘事策略與分鏡腳本(STORYBOARD.md + SCRIPT.md),最終生成配音、字幕及最終影片構圖。此技能支援協作模式(使用者審核每個步驟的產出)與自動模式(跳過使用者偏好問題,但仍需通過品質驗證關卡)。主要產出包含一個可在 localhost 預覽的 Studio 專案,使用者可選擇將其渲染為 MP4。它明確區分於其他影片類型,例如產品發布影片、主題解說影片或 GitHub PR 影片,確保應用場景正確。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

media-use: 在尋找音訊/音效/圖片前,請先呼叫 /media-use 從 HeyGen 目錄中解決 BGM/SFX/圖片的來源。請先執行 --adopt 來註冊現有資產。詳見 /media-use 技能。

網站轉 HyperFrames

抓取一個網站,然後從中產出一支專業影片。

請在步驟 0 之前確認路線。 此技能是爲了一個 一般網站 製作影片。如果使用者真的是要 行銷 / 推出 / 推廣一個產品(即使是從這個網址,即使是「我們網站的宣傳」)→ /product-launch-video。一個 沒有網站的主題解說 → /faceless-explainer;一個 GitHub PR → /pr-to-video;重新剪輯 / 重新調色 / 重新排序一個現有的影片檔案 → 超出範圍。如果使用者含糊地說「製作一個影片」,或者不確定是發布還是一般網站?請先閱讀 /hyperframes(完整路由表 + § HyperFrames 無法做到的事)。

使用者會說像這樣的話:

  • 「把這個網站變成一支 15 秒的 Instagram 社交短片」
  • 「從 https://... 製作一支 30 秒的網站導覽 / 展示影片」
  • 「抓取我們的首頁,並用它的視覺元素來構建一支影片」

工作流程有 7 個步驟。每個步驟都會產出一個工件,作為下一步的關卡。預設為協作模式 — 標示 💬 的關卡會停下來詢問使用者。如果使用者表示要採用自動模式(「幫我決定」、「給我驚喜」),則 💬 使用者偏好關卡會被跳過;詳見 step-2-brief.md 了解如何傳播。

自動模式並非「跳過所有關卡」。 自動模式涵蓋使用者偏好問題(TTS 提供商、語音、顏色強調、節拍數量、是否使用音樂、是否使用字幕 — 由代理人代為決定)。它不涵蓋品質驗證關卡。以下項目在自動模式下仍不可跳過:

  • 資產審計(步驟 3)— 查看連絡表並為每個資產說明使用/跳過的理由
  • 逐拍 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 → 預檢以獲取官方指南。

關卡: 已列印網站摘要 — 先策略(產品做什麼、為誰而做、品牌語氣)再列出資產/顏色/字型庫存;已顯示登入狀態(已登入,或繼續離線)。


步驟 1:品牌識別

閱讀: references/step-1-design.md

撰寫 DESIGN.md — 一個品牌備忘單,涵蓋視覺識別:顏色、字體排印、元件樣式、佈局原則。使用 design-styles.json 獲取精確的計算值。

速度選項: 對於快速節奏的影片(每個拍子一個廣告看板),DESIGN.md 可以是一份 50 行的顏色 + 字型 + 注意事項摘要 — 而不是一份 300 行的文件。步驟 5 的子代理人提示會直接貼上品牌價值,因此 DESIGN.md 的深度僅對複雜構圖重要。

關卡: DESIGN.md 存在(任何長度)且至少包含:顏色調色盤、字型選擇、以及注意事項。


步驟 2:策略與訊息傳遞

閱讀: references/step-2-brief.md, references/capabilities.md(掃描目錄 — 深度章節僅在需要時閱讀)

在討論視覺或資產之前,先與使用者對齊 影片必須傳達的訊息。解析使用者的提示 — 他們很可能已經告訴你影片類型和風格。只詢問缺少的部分:這支影片必須說的「一句話」、敘事弧線、以及目標觀眾。

關卡: 影片類型、時長、格式、以及 — 關鍵地 — 訊息和敘事弧線都已被鎖定。沒有這些,步驟 3 無法撰寫以概念為先的分鏡腳本。


步驟 3:分鏡腳本 + 腳本 💬

閱讀: references/step-3-storyboard.md

以概念為先撰寫分鏡腳本:訊息 → 敘事弧線 → 服務於弧線的拍子 → 每個拍子的技術 → 最後的品牌強調處理。然後撰寫匹配的旁白腳本。向使用者呈現兩者,並附上逐拍摘要。不斷修改直到他們批准。

關卡: STORYBOARD.md + SCRIPT.md 存在 且 使用者已批准該計劃。


步驟 4:配音、計時 + 字幕 💬

閱讀: 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

進行語法檢查、驗證、根據影片長度調整快照數量(公式:max(拍子數 × 3, ceil(秒數 / 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 個精心計時的拍子。一個只有一個強烈視覺論述的品牌形象片可能只需要 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 — 語法檢查、驗證、快照(根據影片長度調整)、預覽
techniques.md步驟 3 和 5 — 13 種基本動畫技術及程式碼模式(採用,不要複製貼上)
html-in-canvas-patterns.md步驟 5 — HTML 嵌入 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.

相關技能