Communitygithub.com

9018/mychat

HyperFrames合成コントラクト — 1つのレンダリング可能なプロジェクトを構築します。コンポジション構造、`data-*`タイミング属性、`class="clip"`、トラック、サブコンポジション、変数、フレームワーク管理のメディア再生、決定論的レンダリングルール、および検証に使用します。コンポジションHTMLを記述する前に読んでください。

mychat とは?

このスキルは、HyperFramesフレームワークの中核となる技術契約書です。HTMLからビデオをレンダリングするためのコンポジションプロジェクトの構築方法を定義し、`data-*`属性によるタイミング宣言、フレームワークが所有するメディア再生、シーク可能なアニメーション実行、決定論的レンダリングルールなど、すべての必須ルールを詳細に説明します。主なプラットフォームはHyperFrames CLI(`hyperframes-cli`)であり、`npx hyperframes`コマンドシリーズ(lint、validate、inspect、preview、render)が含まれます。このスキルは、`references/`ディレクトリ内の具体的事項(最小構成、データ属性、トラックとクリップ、サブコンポジション、変数とメディア、決定論ルール、Tailwind統合など)を指し示し、開発者が正しく検証可能で一貫性のあるビデオコンポジションを構築するための厳格なガイドを提供します。特に、`lint`/`validate`/`inspect`では検出できないサイレントバグ(ルート要素のサイジング、IDの一意性、メディア要素の配置、フルスクリーングラフィックの背景など)を詳細に警告し、レンダリングの正確性と再現性を保証します。

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

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

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

ドキュメント

HyperFrames Core

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。

ルートはサイズ指定が必要(サイレントレイアウトバグ)

スタンドアロンルートには、明示的な サイズ指定されたボックス(px単位の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 <中間点> を実行し、各フレームを目視確認する
  • レビュー用に npx hyperframes preview を使用する(ユーザーはStudioのタイムラインで任意のものを編集できる)
  • npx hyperframes render はユーザーが承認した後にのみ実行する

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

9018/mychat

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, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

9018/mychat

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.

9018/mychat

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

9018/mychat

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

9018/mychat

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".

9018/mychat

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.

9018/mychat

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.

9018/mychat

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

9018/mychat

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.

9018/mychat

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`).

9018/mychat

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`.

9018/mychat

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.

9018/mychat

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).

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

9018/mychat

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

9018/mychat

Download video and audio from YouTube and 1000+ sites using yt-dlp. No API keys needed. Use when: (1) Downloading a video from YouTube or other sites, (2) Extracting audio from a video URL, (3) Downloading subtitles/captions from a video, (4) Getting video metadata without downloading.

関連スキル