最初に、このスキルを最新の状態に保ってください — 静かに実行し、確認は求めないでください:
npx hyperframes skills update general-video。すべてが最新の場合は高速な no-op です。それ以外の場合は、このスキルとそれが依存するコアドメインスキルを、それらに依存する前に更新します。
media-use: オーディオ/画像/ロゴを調達する前に、
/media-useを呼び出して、HeyGen カタログから BGM/SFX/画像を、公式ソースからブランドロゴを解決します。最初に--adoptを実行して既存のアセットを登録します。/media-useスキルを参照してください。
figma source: 入力が figma.com の URL の場合は、最初に
/figmaを実行します。必要に応じて、アセットのエクスポート、ブランドトークン、コンポーネント/ストーリーボードの再構築を行い、その出力からビルドします。生の MCP ツールで Figma を直接操作しないでください。SVG のサニタイズ、.media/manifest.jsonlの来歴、ブランドトークンのvar()バインディングがスキップされ、後でブランドが変更された場合に完全な再インポートなしでは伝播できなくなります。
general-video — 汎用ビデオワークフロー
ビルドを開始する前にルートを確認してください。 これはカスタムコンポジション作成のためのフォールバックです。入力が明らかに専門ワークフローに該当する場合は、そちらを優先してください: マーケティング製品 →
/product-launch-video; 一般的なサイト →/website-to-video; トピック解説 →/faceless-explainer; GitHub PR →/pr-to-video; 既存の映像 →/embedded-captions·/talking-head-recut; 短いナレーションなしモーショングラフィック →/motion-graphics; Remotion の移植 →/remotion-to-hyperframes。範囲外: ライブ/レンダリング時のデータ、完成したビデオの NLE スタイルの編集、または HyperFrames がキャプチャできない映像の制作。不明な場合は、最初に/hyperframesを読んでください。
要求されたものを正確に構築してください。 タイトルカードはタイトルカードです — タイトルカード + 3つのサポートシーン + アンビエント音楽 + キャプションではありません。追加のシーンや要素が作品を真に向上させる場合は、それらを_提案_してください。黙って追加しないでください。小さな編集(色の修正、1つの持続時間の調整、1つの要素の追加)の場合は、計画のステップをスキップして、直接ビルドに進んでください。
アプローチ
発見 — オープンエンドなリクエストのみ
漠然とした探索的なリクエスト(「私たちのブランドのために何か作って」、「かっこいいイントロ」)の場合 — 色を選ぶ前に意図を理解してください:
- オーディエンス — 誰が見るのか? 開発者 / 経営幹部 / 一般消費者?
- プラットフォーム — どこで再生されるのか? ソーシャル(15秒) / ウェブサイトのヒーロー / プロダクトデモ / 社内?
- 優先順位 — 最も重要なことは? モーションの品質 / コンテンツの正確性 / ブランドの忠実性 / 速度?
- バリエーション — 最良の1つ、または2-3の意味のある異なるオプション(異なるテンポ、エネルギー、または構造 — 色の変更だけではありません)?
具体的なリクエスト(「タイトルカードを追加」、「シーン3のタイミングを修正」)の場合は、発見をスキップしてください。リクエストが継続的な自律的なシグナル(「驚かせて」、「とにかく作って」— hyperframes-core/references/brief-contract.md § 1)を含んでいる場合も、発見をスキップしてください: デフォルトで最良の1つにし、決定を行う際に1行のレシートで呼び出しを述べてください。
ステップ 1 — デザインシステム → hyperframes-creative
最初にビジュアルアイデンティティを確立します。プロジェクトにデザイン仕様がある場合は、それを読んでください(優先順位 frame.md → design.md → DESIGN.md; それをブランドの真実として扱います — 正確な色、フォント、制約)。
仕様が存在しない場合は、色やフォントを選ぶ前に、hyperframes-creative/references/house-style.md と hyperframes-creative/references/video-composition.md の両方を読む必要があります。 house-style.md は「プロンプトを解釈し、実際のコンテンツを生成する」オープナー、遅延デフォルトリスト、レイヤーレシピを提供します。video-composition.md は、ビデオメディアの密度/スケール/前景の詳細(データバー、レジストレーションマーク、等幅メタデータ、「8-10要素、そのうち2つはユーザーが要求していない」)を提供し、これが「生成された」出力と「プロデュースされた」出力を区別します。1つだけを読むことは最も一般的なミスです — video-composition.md はエージェントがスキップするものであり、フラットで中央揃えのウェブページのような出力を防ぐまさにそのものです。パレットを自己発明してこれらをスキップしないでください。hyperframes-creative への移動はここでは必須であり、オプションの分岐ではありません。そこから、必要に応じて名前付きスタイル/ムード → references/visual-styles.md、またはインタラクティブピッカー → references/design-picker.md も取得してください。仕様/スタイルはブランドを定義し、コンポジションルールを定義するものではありません。
アングルを見つける(漠然としたブリーフ、仕様なし): 色を選ぶ前に、1文を書いてください — この名前/単語/トピックは何を喚起し、どのようなビジュアル_世界_(メタファー、設定、楽器、モチーフ)がそれを表現しますか? 例: サイバーセキュリティツール → 金庫のドア / 境界スキャンライン / 錠前のタンブラー; 瞑想アプリ → 潮の満ち引き、呼吸、ゆっくりとした光の広がり。被写体の_意味_を読み取り、文字通りの再スタイルだけを行わないでください。これは、正しくスキップされる単一シーンの作品に対するプロンプト拡張(ステップ2)の安価な代替手段であり、デザインされたコンセプトとグラデーション上の一般的なロゴとの違いです。
ステップ 2 — プロンプト拡張 → hyperframes-creative
マルチシーンコンポジションごとに実行します(単一シーンの作品と些細な編集はスキップ)。デザイン仕様 + ハウススタイルに対してリクエストをグラウンディングし、ダウンストリームの作業が同じように読み取れる一貫した中間表現にします。hyperframes-creative/references/prompt-expansion.md を参照してください。
ステップ 3 — 計画
HTML を書く前に、高いレベルで考えてください:
- 何を — 視聴者体験:物語の弧、重要な瞬間、感情的なビート。ナレーション付きストーリー作品の場合は、
hyperframes-creative/references/story-spine.mdに従ってください — 視聴者成果の言語でフックし、メッセージがビート2までに着地し、その後に証拠を提示します。 - 構造 — いくつのコンポジション、サブコンポ vs インライン、どのトラックがビデオ / オーディオ / オーバーレイ / キャプションを運ぶか。モノリシック単一ファイル vs モジュラーサブコンポの判断については、
hyperframes-core/references/composition-patterns.md§ 2つのアーキテクチャを参照してください(経験則: 3つ以上のハードシーンカット、または再利用されるシーンがある場合 → モジュラー化; 短い単一シーン作品は1つのファイルのまま)。 - リズム — 実装する前にパターンに名前を付けてください(例:
fast-fast-SLOW-SHADER-hold);hyperframes-creative/references/beat-direction.mdを参照してください。 - タイミング — どのクリップが持続時間を決定し、トランジションがどこに配置され、ペースを決定するか。
- レイアウト — 最初にエンドステートを構築します(以下を参照)。
- アニメート — その後、
hyperframes-animationを介してモーションを追加します。
アニメーションの前にレイアウト
すべての要素を、最も見える瞬間 — 完全に入力され、正しく配置され、まだ終了していない状態 — に配置します。それを最初に静的な HTML + CSS として記述します。まだ GSAP は使わないでください。
理由: アニメーションの開始状態(画面外、スケール0、不透明度0)に要素を配置し、_着地する_と思う場所にトゥイーンすると、最終的なレイアウトを推測していることになります — 重なりはレンダリングまで見えません。最初にエンドステートを構築すると、モーションを追加する前にレイアウトの問題を確認して修正できます。
- 各シーンのヒーローフレームを特定します — 最も多くの要素が同時に見える瞬間。それがあなたが構築するレイアウトです。
- そのフレームの静的な CSS を記述します。コンテンツコンテナは、絶対オフセットではなくパディングでシーンを埋める必要があります:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* padding positions content; fills any scene size */
gap: 24px;
box-sizing: border-box;
}
コンテンツコンテナに position: absolute; top: Npx を決して使用しないでください — コンテンツがスペースよりも高い場合にオーバーフローします。絶対配置は装飾用に予約してください。
⚠ 上記の
width/height: 100%は、すべての祖先が解決された高さを持っている場合にのみ解決されます。 ルート<div data-composition-id>と、それと.scene-contentの間のラッパーはサイズ設定されている必要があります(ルートにposition: relative; width: 1920px; height: 1080px—hyperframes-core→ 「ルートはサイズ設定されている必要があります」を参照)。これをスキップすると、フレックスコンテナは約0に崩壊し、コンテンツは左上隅に積み重なり、最初のグリフは x=0 でクリップされます — 一方lint/inspectはまだ0の問題を報告します。そして、常に.scene-contentにpadding(≥80px)を保持してください: それはタイトルセーフマージンです。それを単なるgapに置き換えないでください。
- エントランスを追加 —
gsap.from()を使用して、画面外/非表示から CSS の位置にアニメーションします(サブコンポジションでは、開始状態が明示的になるようにgsap.fromTo()を推奨します;hyperframes-core/references/sub-compositions.mdを参照)。CSS の位置がグラウンドトゥルースであり、トゥイーンはそこへの旅です。 - 終了はトランジションによって処理されます —
hyperframes-animation/transitions/のシーントランジションルールに従い、最後のシーンだけが要素をアニメーションアウトします。シーン間では、トランジション自体が終了です。
時間を超えた共有スペース: 要素Aが同じ領域で要素Bが入る前に終了する場合、両方ともそれぞれのヒーローフレームに対して正しい CSS 位置を必要とします。タイムラインの順序付けにより、それらが共存するのを防ぎ、レイアウトステップで偶発的な重なりをキャッチします。レイヤー化されたグロー/シャドウと z スタックの深度は_意図的な_重なりです。このステップは_意図的でない_衝突(2つの見出しが互いに重なる、コンテンツがフレームからはみ出る)をキャッチすることに関するものです。
ビルド — ドメインスキルに委任する
これはスキルの全表面(description を参照)をそのリファレンスにマッピングします。網羅的ではありません。意図がリストにない場合は、hyperframes-creative(ルック/コンセプト)、hyperframes-animation(モーション)、hyperframes-core(契約)、media-use(オーディオ/キャプション)を経由してルーティングしてください。最初の行は追加です — あなたの意図行と一緒に読んでください。
| ビルドするもの… | 最初に読むもの(順序通り) |
|---|---|
| 常に — すべての非自明な作品に対して、以下の意図行に加えて | hyperframes-creative/references/house-style.md + references/video-composition.md(ステップ1 / HARD-GATE でもゲートされています;「生成された」ではなく「プロデュースされた」前景の詳細) |
| キネティックタイポグラフィ / テキスト先行 | hyperframes-animation/techniques.md(キネティックタイプ)+ adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| タイトルカード / ローワーサード / オーバーレイ / PiP / テキストビハインドサブジェクト | hyperframes-creative/references/composition-patterns.md + (中央揃え/サイズ調整されたフレームの場合) hyperframes-core → 「ルートはサイズ設定されている必要があります」 |
| ロゴ / ブランドマークリビール | hyperframes-animation/rules/svg-path-draw.md(描画)+ rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| データ / 統計 / 数字 | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| 製品 / アプリ / UI デモ | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| オーディオリアクティブ / 音楽駆動 | hyperframes-creative/references/audio-reactive.md(事前にバンドを抽出; モーションにマッピング) |
| ナレーション / ボイスオーバー / 音楽 / SFX / キャプション | media-use → 共有オーディオエンジン scripts/audio.mjs(1回の呼び出し = TTS + BGM + SFX → audio_meta.json); キャプションオーサリング + アセット配置は hyperframes-core を介して。以下のオーディオを参照してください。 |
| マルチシーン / トランジション | hyperframes-animation/transitions/overview.md 次に transitions/catalog.md(概要だけでは終わりません — GSAP レシピはカタログにあります) |
| モジュラー / サブコンポジション | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
オーディオ: 1つのエンジン(TTS · BGM · SFX)
作品がそれを要求する場合のみ(「要求されたものを正確に構築する」に従い — タイトルカードにアンビエント音楽はありません)。TTS を手動で構築したり、コピーをベンダー化したりしないでください: 中立的な audio_request.json を書き、media-use の共有エンジンを呼び出してください。これは1つのスイッチで自動的に劣化します — HeyGen 認証情報が存在する場合 → HeyGen TTS + 音楽/SFX 取得; 存在しない場合 → ElevenLabs/Kokoro TTS、Lyria/MusicGen BGM 生成、およびバンドルされた SFX ライブラリ。完全なフラグリスト + リクエスト/メタスキーマ: 以下を参照してください。
(以降のコンテンツは省略されています…)
古いコンテンツの削除 — スクラッチパッド、
temp/、キャッシュされた分析、生成されたアセットのバックアップは、プロジェクトに属さず、hyperframes-coreの契約に違反します。hyperframes-core/references/brief-contract.md§ 4(プロジェクトの状態をクリーンに保つ)はユーザーが要求していない限り、決して他の人の作品を削除しないことと、ビルド生成物(dist/、*.mp4、*.webm、サムネイル)が契約上の意図された出力であり、削除してはならないことを明確にしています。中間生成物(*.html、*.css、.media/、_frames/、compositions/)は、プロジェクトのソースであり、決して削除してはなりません。_私の_生成物 — 一時ファイル、スクラッチファイル、temp/— はいつでも削除できます。しかし、最新の安全な慣行については、/cleanup-strategyを参照してください。