Communitygithub.com

Army161/OpenMontage

用於製作以動態為主、設計導向的短影音:動態文字、數字計數、圖表動畫、Logo 開場、品牌標誌、姓名標籤、社交媒體疊加、動態頭條/推文/新聞、動態海報或快速頁面截圖。通常少於 10 秒,最長約 30 秒,無旁白或實景拍攝。可用 MP4 或透明疊加格式輸出。

OpenMontage 是什麼?

Army161/OpenMontage 是一個專為製作短時、設計導向、無旁白動態圖形影片的 AI 技能,適用於 Claude Code、Cursor 等開發工具。其核心哲學是「動態即訊息」,專注於在 10 到 30 秒內透過純動畫傳達訊息,而非透過敘事。此技能支援多種內容類型,例如動態文字排版、數據統計計數、圖表動畫、Logo 開場、社群媒體疊加等。工作流程採用「素材優先」策略:首先決定素材策略並獲取真實素材,再根據素材設計鏡頭,最後透過重複使用目錄區塊來組合場景。若使用者需求為更長、多場景或有旁白的影片(如品牌介紹、網站教學影片),此技能會引導至其他專門技能,確保任務能獲得最合適的處理。

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

在你喜歡的 AI 中提問

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

說明文件

動態圖形 — dispatch 入口

在步驟 0 之前確認路線。 此技能製作 短小、設計導向、無旁白的動態圖形(動態即訊息;約小於 10 秒,無配音)。較長、多場景或有旁白 的影片 → /general-video;網站介紹影片 → /website-to-video;主題解說 → /faceless-explainer;產品宣傳 → /product-launch-video;在現有影片上加字幕 → /embedded-captions。超出範圍:即時 / 渲染時的數據,或無法捕捉的影片素材。不確定是動態優先還是旁白優先?請先閱讀 /hyperframes。

一個短小、設計導向的動態圖形。素材優先:在設計鏡頭之前,先決定素材策略並取得真實素材;然後根據你所擁有的素材來設計鏡頭;最後透過重複使用目錄功能來組合。所有成品都放在 PROJECT_DIR = videos/<project-name>/(在步驟 0 中建立);以下所有路徑都相對於此目錄。

階段執行方式主要成品詳細流程
initBashhyperframes.json步驟 0
plan子代理 — 決定是否搜尋? + 分類 + 素材策略shot-plan.json(草案:類別、asset_needs 查詢、簡要)agents/director.md(第 1 部分)
source ◇Bash — media-use 解析(若 asset_needs 為空則跳過)assets/ + assets/index.mdphases/source/guide.md
design子代理 — 根據已解析的素材進行鏡頭設計shot-plan.json(最終版:區塊 + 佈局 + 動態 + 位置)agents/director.md(第 2 部分)
build子代理 — 重複使用優先的組合compositions/index.htmlagents/builder.md
renderBash — hyperframes render(MP4,或 --format webm/mov 用於疊加)renders/video.mp4步驟 5
verifyBash — lint / inspect → 失敗時交由修復子代理處理(就地修復)agents/finalize.md

◇ source 僅在所選類別宣告需要素材時執行。純程式碼 / 文字類別(例如 kinetic-type、大多數 charts/stat)的 asset_needs: [],會從規劃直接跳到設計。

類別 — 根據搜尋決策拆分

plan 的第一個決策是:是否需要搜尋? 這個分岔將類別分為兩組;然後選擇具體類別 — 對於搜尋驅動型,根據搜尋回傳的內容類型。每個類別都有一個 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-revealLogo 開場 / 品牌標誌(使用者提供的 Logo)logo-outro / rules/svg-path-draw
lower-thirds姓名 / 職稱條、標註、社交媒體疊加caption-* + 註冊疊加區塊

搜尋驅動型類別 — 先搜尋,然後根據內容類型製作動畫(RWA 路徑):

回傳的內容類別動畫
網頁 / 連結webpage網頁 / UI 動畫(滾動、揭示、游標、標註)
新聞文章news頭條揭示 + 來源卡片 + 關鍵事實標註
推文tweet推文卡片動畫
圖片 / 實體asset-fusion素材的幾何形狀 變成 圖表(RWA 融合)

建構順序:一次一個,以覆蓋率為優先(粗略即可)。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 解析)跳過生成 / 僅搜尋
(asset_scout / 搜尋提供者)webpage/news/tweet + asset-fusion 真實素材搜尋該類別降級為無素材模式

流程

步驟 0 — 初始化

當前工作目錄為代理工作區根目錄;所有成品都寫入 PROJECT_DIR = videos/<project-name>/。<project-name>:使用使用者提供的目錄名稱,否則從意圖中取一個簡短的 kebab-case 名稱(<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" && ...) 的子 shell 中執行 — 永不使用裸的 cd。

步驟 1 — 規劃(子代理:導演第 1 部分)

分派一個子代理。提示 = 完整的 agents/director.md + ## 分派上下文(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[](新聞 / 網頁 / 推文 / 圖片;兩個極端的查詢)。具體的搜尋驅動型類別(webpage / news / tweet / asset-fusion)將由步驟 2 回傳的內容類型確認,並在步驟 3 最終確定。
  2. 撰寫一個草案 shot-plan.json(信封 + 所選形式類別 或 搜尋意圖 + asset_needs + 一段鏡頭簡要)。架構:references/shot-plan-ir.md。

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

步驟 2 — 來源 ◇(Bash:media-use,條件執行)

如果 shot-plan.json.asset_needs 不為空,則解析素材(搜尋 / 生成 / 擷取 → 凍結的專案本地路徑 + 帳本)。請參閱 phases/source/guide.md(包裝 media-use resolve;搜尋驅動型類別使用新聞/網頁/推文/圖片搜尋)。如果 asset_needs 為空,則跳至步驟 3。

# 說明用 — 請參閱 phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

優雅降級:如果搜尋/提供者不可用,該類別會退回至無素材模式(在 context.log 中記錄)。

步驟 3 — 設計(子代理:導演第 2 部分)

分派一個子代理(提示 = agents/director.md 第 2 部分 + 分派上下文,包含已解析的 assets/index.md(如果步驟 2 已執行)+ catalog-map.md)。它根據可用的素材設計鏡頭:選擇目錄區塊 + hyperframes-animation 規則/藍圖、佈局、動態、節拍,以及(對於 asset-fusion)element_positions + 滴管調色板。最終確定 shot-plan.json(content.block + content.customize + 各類別專屬內容)。

步驟 4 — 建構(子代理:建構者,重複使用優先)

分派一個子代理。提示 = 完整的 agents/builder.md + 分派上下文(shot-plan.json、catalog-map.md、該類別的 module.md、references/motion-vocabulary.md、references/builder-contract.md)。重複使用優先:npx hyperframes add <block> + 就地自訂;僅手動撰寫空白部分 + asset-fusion 的特定功能。輸出 compositions/index.html,並遵守 HF 合約(暫停的 GSAP 時間軸在 window.__timelines 上、class="clip" + 穩定的 ID、tl.seek(0)、確定性)。

步驟 5 — 渲染(Bash)

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# 透明疊加變體:--format webm(或 mov)

步驟 6 — 驗證(Bash → 失敗時交由修復子代理處理)

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

exit 0 → 完成。若 lint/inspect 出現錯誤,則分派修復子代理(agents/finalize.md:快照 QA + 一次就地修復 + 重新渲染)。修復過程中絕不變更已固定的持續時間。

報告 + 可選預覽

報告最終輸出(renders/video.mp4,或 .webm / .mov 疊加變體)+ 持續時間。在執行期間不要開啟預覽。 僅在請求時提供,並在渲染後啟動,以便提供最終檔案:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # 工作室 UI;或 `npx hyperframes play` 取得可分享連結

標誌位於 hyperframes-cli 技能中(references/preview-render.md)。

恢復表

狀態從何處繼續
無 shot-plan.json步驟 1(規劃)
shot-plan.json 有 asset_needs,無 assets/步驟 2(來源)
shot-plan.json 已最終確定,無 compositions/index.html步驟 3/4(設計+建構)
compositions/index.html 存在,無 renders/video.mp4步驟 5(渲染)+ 步驟 6
renders/video.mp4 存在報告 + 停止

設計備註(維護者 — 執行過程不會讀取此處)

  • 素材優先的理由: 素材取得被提前執行,並為鏡頭設計提供資訊(RWA 流程:分析 → 搜尋 → 審查 → 組合)。搜尋驅動型類別(webpage/news/tweet)和 asset-fusion 都依賴 media-use 搜尋(新聞/網頁/推文/圖片),這是 media-use 文件記錄的 RWA 血統。
  • 重複使用優先: 生態系統中類似 LLM 生成模板的方案是「組合目錄區塊 + hyperframes-animation 規則」。HF 的暫停 GSAP 時間軸 ≙ Remotion 的 useCurrentFrame。
  • 類別模組合約: 一個 categories/<id>/module.md(規劃 + 建構),共享 references/motion-vocabulary.md(+ 可選評估)。新增一個類別 = 放入資料夾 + 在 agents/director.md 中註冊其分類器行 + 在 catalog-map.md 中註冊其資料列;階段管線保持不變。
  • 目錄結構:
    videos/<project-name>/
      hyperframes.json  context.log
      shot-plan.json            # 中間表示法 (導演輸出)
      assets/  assets/index.md  # media-use 輸出(如果已取得素材)
      compositions/index.html   # 建構者輸出
      renders/video.mp4
    
  • 註冊: 在 hyperframes 路由器中 — 新增「設計導向的短動態圖形」意圖 + 工作流程描述;從 /general-video 中劃分出動態圖形觸發條件;新增反向禁止使用邊緣。請參閱 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.

相關技能