Communitygithub.com

Army161/OpenMontage

用于用户想要一个简短、以设计为主导的动效图形,其中动效本身就是信息:动态排版、数据或数字滚动、图表/数据可视化高亮、标志动画、品牌组合、下三分之一、标注、社交覆盖层、动画标题/推文/新闻、动态海报或快速捕获的页面高亮。通常在10秒内,最长约30秒,无旁白、配音或实景主题。可渲染为MP4或透明叠加层。不适用于较长的、多场景的、带旁白的或品牌短片(请使用general-video)、带旁白的网站视频(website-to-video)、主题讲解(faceless-explainer)、产品促销(product-launch-video)、公关视频(pr-to-video)或现有素材上的字幕(embedded-captions)。如果不确定是快速动效优先作品还是较长/带旁白的作品,请查看/hyperframes。

OpenMontage 是什么?

Army161/OpenMontage 是一个专门用于生成短小精悍、以设计为主导的动效图形(motion-graphics)的 AI 技能。其核心特点是“动效即信息”,作品通常在10秒以内,最长不超过30秒,且无人声旁白或实景拍摄。该技能支持多种动效类别,包括动态排版(kinetic-type)、数字滚动(stat)、数据图表(charts)、标志动画(logo-reveal)以及下三分之一/社交覆盖层(lower-thirds)等。对于需要外部内容的类型,如网页、新闻、推文或图片,它会先进行搜索获取素材,再基于内容进行动画设计。该技能依赖 Hyperframes 框架运行,要求 macOS Apple Silicon 或 Linux x64 系统,并需安装 Node.js 和 FFmpeg 等工具。整个工作流从项目初始化开始,经过规划、素材获取、设计、构建、渲染到验证,最终输出 MP4 或透明叠加格式的视频文件。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

动效图形 — 调度入口

在步骤0之前确认路线。 此技能生成一个 短小、以设计为主导、无旁白的动效图形(动效即信息;约10秒内,无配音)。较长、多场景、或带旁白 的处理方式 → /general-video;带旁白的网站视频 → /website-to-video;主题讲解 → /faceless-explainer;产品促销 → /product-launch-video;在现有素材上添加字幕 → /embedded-captions。不在范围内:实时的/渲染时数据,或无法捕获的素材。不确定是动效优先还是带旁白?请先阅读 /hyperframes。

一个短小的、以设计为主导的动效图形。资产优先:在设计镜头之前先决定资产策略并获取真实素材,然后围绕你所拥有的资源设计镜头,最后通过重用目录能力来合成。所有产物都放在 PROJECT_DIR = videos/<project-name>/(在步骤0创建);以下所有路径都相对于此目录。

阶段执行主要产物详细流程
初始化Bashhyperframes.json步骤0
规划子代理 — 决定是否需要搜索? + 分类 + 资产策略shot-plan.json(草稿:类别、asset_needs 查询、简介)agents/director.md(第1部分)
素材 ◇Bash — media-use 解析(如果 asset_needs 为空则跳过)assets/ + assets/index.mdphases/source/guide.md
设计子代理 — 围绕已解析资产进行镜头设计shot-plan.json(最终版:块 + 布局 + 动效 + 位置)agents/director.md(第2部分)
构建子代理 — 重用优先的合成compositions/index.htmlagents/builder.md
渲染Bash — hyperframes render(MP4,或使用 --format webm/mov 生成叠加层)renders/video.mp4步骤5
验证Bash — lint / inspect -> 失败时派发修复子代理(就地修复)agents/finalize.md

◇ 素材 仅在选择类别声明了资产时运行。纯代码/文字类别(例如 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-reveal标志动画 / 品牌组合徽标(用户提供)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)   # Studio 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            # IR(导演输出)
      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.

相关技能