Communitygithub.com

Army161/OpenMontage

捕获一个通用网站/URL,利用其自有视觉元素和品牌资产,将其转化为 HyperFrames 视频(站点导览、展示或社交媒体短片)。

OpenMontage 是什么?

这个技能,名为 Army161/OpenMontage,专门用于从通用网站 URL 生成专业的 HyperFrames 视频内容。它通过使用无头 Chrome 截取网站截图并结合品牌资产,将网站转化为站点导览、作品集展示或社交媒体剪辑。该技能提供了完整的多步骤工作流程,从捕获和理解品牌开始,经过品牌识别设计、策略与信息对齐、故事板与脚本编写、配音与时机确定、合成构建,最后是验证与交付。工作流支持协作模式和自主模式,但关键的质量验证步骤即使在自主模式下也不可跳过,确保输出高质量的视频。它明确区分了与其他视频制作路线(如产品发布视频、话题解释视频或 GitHub PR 转视频)的使用场景,并建议在不确定时参考 `/hyperframes` 技能。该技能适用于 Claude Code、Codex 等 AI 代理工具。

兼容平台~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 从 HeyGen 目录中获取 BGM/音效/图片。先运行 --adopt 注册已有资产。详情见 /media-use 技能。

网站转 HyperFrames

捕获一个网站,并从中制作专业视频。

在第 0 步之前确认路径。 此技能制作的是 针对 / 来自一个通用站点 的视频。如果用户实际上是 营销 / 发布 / 推广一个产品(即使来自此 URL,即使是“我们网站的推广片”)→ 使用 /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 步)——每个节拍的结构化证据块
  • 完成定义检查清单(第 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 行的颜色+字体+注意事项摘要——而非 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

进行 lint 检查、验证、根据视频长度缩放拍摄快照(公式: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 步——lint 检查、验证、快照(根据视频长度缩放)、预览
techniques.md第 3 步和第 5 步——13 种原始动画技术及代码模式(适配,勿复制粘贴)
html-in-canvas-patterns.md第 5 步——Canvas 内 HTML 效果的完整代码模式(位于 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.

相关技能