Communitygithub.com

Army161/OpenMontage

HyperFrames合成契約 — 単一のレンダリング可能なプロジェクトを構築します。合成構造、`data-*`タイミング属性、`class="clip"`、トラック、サブ合成、変数、フレームワーク所有のメディア再生、決定論的レンダリングルール、および検証に使用します。合成HTMLを作成する前に必ずお読みください。

OpenMontage とは?

このスキルは、HyperFramesフレームワークにおける「合成(Composition)」の技術仕様を定義する中心的な契約書です。HyperFramesはHTMLからビデオをレンダリングするシステムで、このスキルは単一のレンダリング可能なプロジェクト(合成)を構築するための完全なガイドを提供します。具体的には、DOM上の`data-*`属性によるタイミング宣言、`class="clip"`を使ったクリップ定義、トラック管理、サブ合成の組み込み、変数とメディア(ビデオ/オーディオ)の取り扱い、そして決定論的レンダリングのためのルール(禁止事項やアニメーション可能プロパティのホワイトリストなど)を詳細に解説します。さらに、`npx hyperframes lint`、`validate`、`inspect`、`snapshot`、`preview`、`render`といったCLI検証コマンドの使用手順や、既存の合成を編集する際の注意点(一意なIDの重要性、トラックの重複回避など)も網羅しています。他の関連スキル(`hyperframes-animation`、`hyperframes-creative`など)への参照も含まれているため、ユーザーはこのスキルを出発点としてHyperFrames全体の能力を体系的に学習できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Army161/OpenMontage/tree/HEAD/.agents/skills/hyperframes-core

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

HyperFrames コア

HyperFrames は HTML からビデオをレンダリングします。コンポジションとは、DOM が data-* 属性でタイミングを宣言し、アニメーションランタイムがシーク可能で、メディア再生がフレームワークによって所有される HTML ファイルです。

このスキルは技術的な契約書 — 1 つの 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.mddata-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.mdSTORYBOARD.md 計画 (+ 解析されたマニフェスト) を作成する
references/script-format.mdオプションの SCRIPT.md 固定ナレーションを作成する
references/subagent-dispatch.mdサブエージェントディスパッチ動詞 (並列ファンアウト / バックグラウンド / 待機) をハーネスにマッピングする
references/tailwind.mdTailwind v4 プロジェクトで作業する (init --tailwind; ランタイム契約は Studio の v3 とは異なる)

アニメーションランタイム固有の詳細 (GSAP API、Lottie、Three.js など) については hyperframes-animation → adapters/<runtime>.md を参照してください。

コンポジションを構築する

2 つのルート形式 (交換不可)

  • スタンドアロン (トップレベルの 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 を参照してください。

ルートにはサイズ指定が必要 (静かなレイアウトバグ)

スタンドアロンルートには明示的なサイズ指定されたボックス (ピクセル単位の width/height) が必要であり、height:100% の要素までのすべての祖先は、解決された高さを持っている必要があります。そうしないと、flex/100% の子要素が約 0 にまで縮小し、コンテンツが左上隅に積み重なります。lint/validate/inspect はこれを検出しません。スケルトンについては references/minimal-composition.md を参照してください。

1 つの一時停止されたタイムライン

各コンポジションは、window.__timelines["<id>"] (キー = ルートの data-composition-id) に正確に 1 つの gsap.timeline({ paused: true }) を登録し、ページ読み込み時に同期的に構築されます。レンダリング期間 = ルートの data-duration であり、タイムラインの長さではありません。サブタイムラインを手動でホストにネストしないでください。完全な契約 (非 GSAP ランタイムを含む) については、references/determinism-rules.md + hyperframes-animation/adapters/ を参照してください。

譲れないルール (lint/validate/inspect が検出しない静かなバグ)

ここに示します。完全な根拠はリンクされたリファレンスにあります。違反しないでください:

  • レンダリング時間のクロック / 未シードの 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.

関連スキル