Communitygithub.com

Army161/OpenMontage

HyperFrames合成合约——构建一个可渲染的项目。用于组合结构、`data-*`时间属性、`class="clip"`、轨道、子合成、变量、框架拥有的媒体播放、确定性渲染规则和验证。在编写合成HTML之前请阅读。

OpenMontage 是什么?

该技能定义了HyperFrames的核心技术契约,HyperFrames是一个能够从HTML渲染视频的框架。它规定了如何构建一个可渲染的合成项目,包括使用`data-*`属性声明DOM时序、可搜索的动画运行时以及由框架托管的媒体播放。该技能详细介绍了两种根形式(独立式和子合成),并强调了重要的限制,例如需要明确的尺寸、只有一个暂停的时间线以及关键的非协商规则(例如禁止运行时时钟、无限制重复、禁止显示/可见性动画)。它包含一系列参考文档,涵盖最小化合成、模式、数据属性、轨道、子合成、变量、确定性渲染和故事板格式。该技能还提供了验证步骤,使用HyperFrames CLI命令(lint、validate、inspect、snapshot、preview、render)来确保合规性并避免静默布局错误。它适用于AI编码工具,如Claude Code和Cursor,并且对于任何使用OpenMontage/HyperFrames生态系统的开发者来说都是必不可少的。

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

在你喜欢的 AI 中提问

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

文档

HyperFrames 核心

HyperFrames 从 HTML 渲染视频。合成是一个 HTML 文件,其 DOM 通过 data-* 属性声明时序,其动画运行时是可搜索的,并且媒体播放由框架拥有。

此技能是技术契约——如何构建一个 hyperframes 项目。下面的正文是构建指南;每个主题的详细信息在 references/(下一个索引)中,按需阅读。其他问题存在于相关的领域技能中——hyperframes-animation、hyperframes-creative、hyperframes-media、hyperframes-cli、hyperframes-registry。/hyperframes 中的能力映射说明了每个技能涵盖的内容。

参考资料

文件阅读它的目的……
references/minimal-composition.md从最小的可渲染合成骨架开始
references/composition-patterns.md选择整体式 vs 模块化;构建模块化 index.html;选择子合成原型
references/data-attributes.md查找任何 data-*(根/剪辑/子合成宿主/遗留别名);使用 class="clip"
references/tracks-and-clips.md选择 data-track-index,处理同一轨道重叠/z-index,使剪辑相对于另一个计时
references/sub-compositions.md连接子合成(宿主属性、<template>、每个实例的变量)并对其内部进行动画
references/variables-and-media.md声明变量;放置 <video>/<audio>,设置音量,修剪
references/determinism-rules.md构建可搜索的时间线;确定性禁止;可动画属性白名单;布局/文本适配
references/full-screen-motion.md使用共享背景创作全帧运动
references/storyboard-format.md创作 STORYBOARD.md 计划(+ 解析后的清单)
references/script-format.md创作可选的 SCRIPT.md 锁定旁白
references/subagent-dispatch.md将子代理调度动词(并行扇出/后台/等待)映射到您的工具套件
references/tailwind.md在 Tailwind v4 项目中工作(init --tailwind;运行时契约与 Studio 的 v3 不同)

有关动画运行时的具体信息(GSAP API、Lottie、Three.js 等),请查看 hyperframes-animation → adapters/<runtime>.md。

构建合成

两种根形式(不可互换)

  • 独立式(顶层 index.html)——根 <div data-composition-id="…"> 直接位于 <body> 中,没有 <template> 包裹(包裹它会隐藏所有内容并破坏渲染)。
  • 子合成(通过 data-composition-src 加载)——根必须包裹在 <template> 中。

⚠ 传输规则:运行时只克隆 <template> 内容;外部的一切(包括 <head> 样式/脚本)都会被丢弃——将 <style>/<script> 放在模板内部。 ⚠ 宿主 ID 规则:宿主插槽的 data-composition-id 必须精确等于内部模板的 data-composition-id 以及 window.__timelines["<id>"] 键——没有 -mount/-slot/-host 后缀。

文件形状、宿主连接和预渲染检查清单 → references/sub-compositions.md。

根必须具有尺寸(静默布局 Bug)

独立根需要一个明确的尺寸框(以 px 为单位的 width/height),并且一直到 height:100% 元素的每个祖先都必须有一个已解析的高度——否则,flex/100% 子元素会塌缩到接近 0,内容将堆积到左上角。lint/validate/inspect 不会捕获这一点。骨架 → references/minimal-composition.md。

一个暂停的时间线

每个合成在 window.__timelines["<id>"] 处注册恰好一个 gsap.timeline({ paused: true })(键 = 根 data-composition-id),在页面加载时同步构建。渲染持续时间 = 根 data-duration,而不是时间线长度。不要手动将子时间线嵌套到宿主中。完整契约(包括非 GSAP 运行时)→ references/determinism-rules.md + hyperframes-animation/adapters/。

不可协商的规则(lint/validate/inspect 不会捕获的静默 Bug)

在此处呈现;完整理由请参见链接的参考。不要违反:

  • 无运行时时钟/未播种的 Math.random/网络/输入状态;无 repeat: -1(使用有限计数)。→ determinism-rules.md
  • 仅对可视化属性白名单进行动画处理;绝不使用 display/visibility;不在后续场景的剪辑上使用 gsap.set。→ determinism-rules.md
  • 正文中无 <br>;变换的元素必须是块级且具有尺寸;脉动的绝对定位装饰元素需要峰值间隙。→ determinism-rules.md
  • <video>/<audio> 必须是宿主根的直接子元素(绝不能在子合成 <template>/包裹器内部);框架拥有播放控制权。→ variables-and-media.md
  • 每个 id 必须在组合后的页面中唯一;在子合成内部,使用合成 ID 作为 id 前缀(#<id>-hero)。重复的 <video>/<img> id 会渲染为空白——生产者通过 getElementById 注入帧,跨文件重复会绕过 lint。→ composition-patterns.md
  • 全屏场景填充应放在一个全出血子元素(position:absolute; inset:0)上,绝不能放在合成根元素本身上——生产者的帧合成可能会丢弃根元素自身的 background(帧渲染为黑色),即使预览/snapshot 显示正确。→ composition-patterns.md

编辑现有合成

  • 首先读取文件。保持无关的时序、轨道、ID、变量、媒体路径不变。
  • 匹配现有的合成 ID 和时间线键。
  • 添加剪辑:选择一个不重叠的 data-track-index 或有意调整周围时序。
  • 添加子合成:在连接宿主之前,验证其内部的 data-composition-id。

验证

使用 hyperframes-cli 了解具体命令

  • npx hyperframes lint 通过(0 错误)
  • npx hyperframes validate 通过(0 控制台错误)
  • npx hyperframes inspect 通过(0 错误)
  • 包含子合成的项目:npx hyperframes snapshot --at <midpoints> 并目测每一帧
  • 使用 npx hyperframes preview 进行审查(用户可以在 Studio 的时间线中编辑任何内容)
  • 只有在用户批准后才执行 npx hyperframes render

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

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.

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.

相关技能