モーションランゲージ は何をしますか?
skills/00-house-rules/SKILL.md を継承します。実装は scripts/stingers.py です。
すべてをレンダリングするギャラリーは scripts/build_stinger_gallery.py です。
重要な唯一の区別
シーンは説明する。スティンガーはジェスチャーする。
| シーン | スティンガー | |
|---|---|---|
| 長さ | 8~15秒 | 2~4秒 |
| 伝えるもの | 読まなければならない主張 | すでに聞いた一つのアイデア |
| 顔 | 隠れているかPiP | 隠れている — それにカットインする |
| 数 | 10分の動画に3~6個 | 20~40秒ごとに1個 |
| 削除した場合 | ポイントが伝わらなくなる | 動画が平坦になるが、間違いにはならない |
これを間違えるのがよくある失敗です。実際の内容を含む3項目のリストは compare シーンです。同じリストを steps として使うと装飾になります。視聴者がそれを読む必要があるなら、それはスティンガーではありません。
スティンガーは上に重ねるのではなく、カットインします。 数秒間、フレーム全体を占有します。スピーカーが背後に見えたままの全画面グラフィックはミスと見なされ、3秒間顔がなくても問題にはなりません。
語彙
5つの要素。ライブラリ内のすべてはこれらの組み合わせであり、これが無関係なアニメーションを一つのシステムとして読ませる理由です。
| グラウンド | ほぼ黒で、ソフトな放射状の明るさを持ちます。フラットな #000 は避ける — 真っ黒なフレームはドロップアウトと見なされ、デザインとは見なされません。 |
| ガラス | 約4.5%のインクの半透明フィル、1pxの境界線(約14%)、半径26。奥行きは境界線と内側のハイライトから生まれます。カードにドロップシャドウは絶対に使いません。 |
| シーン | カードが落ち着くときの低角の鏡面スイープ。これが特徴的な動きです — 平らな長方形を物理的なオブジェクトとして読ませるものです。 |
| パス | 約10%のインクの細い破線曲線。ものはパスに沿って移動します。テレポートするものはありません。 |
| ステート | システム状態を示す小さなドットの行。その行の色の変化は、何のコピーもなく「そして壊れた」と言います。 |
間隔は120~160ms。 100ms未満では兄弟要素が一つのオブジェクトとして読まれます。200msを超えると視聴者は待ち始めます。
すべてのスティンガーは最後のフレームを保持します。 スピーチに合わせてカットインするため、決着後のフレームで終了しても安全でなければなりません。ループするものはなく、空のステージで終了するものもありません。
ライブラリ
{ "kind": "converge", "from": "everything feeds into one place", "dur": 3.4,
"chips": ["skill.md", "prompt", "context", "tool", "rule", "doc"] }
| kind | それが属する文 | dur |
|---|---|---|
converge | 「これらすべてが一箇所に集まります。」チップが破線のパスを辿って輝くコアに移動します。負荷がかかるにつれてステートドットが埋まります。 | 3.0~3.6 |
overload | 「そして動かなくなりました。」同じコアが赤くひび割れます。converge の形状を共有するため、2つを一つのストーリーとしてカットできます。 | 2.4~3.0 |
steps | 「このうち3つがあります。」番号付きのガラスカード、間隔をあけて、それぞれにシーン。最も再利用可能で、最も使いすぎられます。 | 2.6~3.2 |
swap | 「これではなく、あれ。」Aに取り消し線が引かれ上に退き、Bがその下に現れます。両方とも読みやすいままです。 | 3.0~3.6 |
countup | 「43%でした。」数字が上昇し、値とともにスケールが大きくなります。可視のソースラインの上に表示されます。 | 2.6~3.4 |
beats | 3つの短いフレーズ、打楽器的。それぞれが共有のビートグリッド上で異なる入場を得ます。 | 2.4~3.2 |
surround | 「ツールに埋もれています。」ラベル付きチップが保持された中心を囲み、その後閉じます。中心は決して動きません。 | 3.2~4.0 |
photo | 加工された既存画像。ガラスカード、スローケンバーンズ、キャプション、クレジット行。 | 2.8~4.0 |
clip | 静止画の代わりにフッテージを保持する同じカード。ケンバーンズなし — すでに動いています。 | 2.4~3.0 |
composition.json 内でシーンとまったく同じように使用します — 同じ from / at / dur アンカー、フレーズが解決しない場合の同じハードエラー。
Bロール:photo / clip スティンガー
2つの処理方法があり、full がそれらを選択します。full はオプトインです。省略するとカードになります。
full: true — Bロール | full: false — 引用 | |
|---|---|---|
| フレーム | 全面、カードなし | ガラスカード、シーン、スロードリフト |
| フレーム上のテキスト | ショットが何であるかを名前を示す lower third | キャプションおよびクレジット行 |
| フレーム上のソース | なし | 必須 |
| 使用目的 | 瞬間を伝えるフッテージと静止画 | スクリーンショット、チャート、価格ページ、文書 |
Bロールは全画面で、ソース参照はありません。人間からの2026-08-14付の継続指示です。 誰もが見たすべての編集でBロールがそうであるように、フレーム全体を占めます。フレーム上に許可されるテキストは、ショットが何であるかを言う lower third のみで、どこから来たかは決して表示しません。帰属表示は依然として行われます — ドロップの _FINAL/ATTRIBUTION.md 内で。これは fetch_stock.py がダウンロード時に書き込み、どの編集もスキップできません。Pexels と Pixabay はどちらもフレーム上のクレジットをオプションにしているため、台帳だけでライセンスを満たし、フレームはクリーンなままです。
これは以前ここにあったBロールに関する段落に取って代わります。 その段落では、全面クリップは「別の動画のように読める」とし、すべてをカードに入れるよう指示していました。その理由は引用の場合にのみ依然として有効です。視聴者が資産を引用している証拠として読むことを意図している場合、full: false とソース行はフレームに戻ります。
ビルダーは依然としてカードをデフォルトとしており、それは意図的です。 デフォルトを反転させると、すでにそれに基づいて書かれたすべての photo シーン(drop-005 の working/stingers/plan.json など)を黙って再処理することになり、昨日カードをレンダリングした仕様は今日も同じカードをレンダリングしなければなりません。新しい作業では "full": true を要求します。skills/executive-animator は常にそうします。カードが完全に廃止された場合、st_photo の一語の変更で済みます。
幾何学上の注意点:全面は object-fit: cover を使用するため、すでに16:9のソースを指定してください。2.19:1のクロップを全画面で表示すると、各辺から221px失われ、すべてのゲートが正しいボックスを報告する一方で、図表の最初と最後の列が切り取られてしまうことになります。
1つのビルダー、2つの名前。 photo は静止画、clip はフッテージです。ファイル拡張子で分岐するため、名前は仕様を読みやすくするためにのみ存在します。実際に変わるものは次のとおりです。
photo | clip | |
|---|---|---|
| 要素 | <img> | フレームワークのタイミングを持つ <video muted playsinline> |
| ケンバーンズ | あり、カード全体で 1.00 → 1.07 | なし |
フッテージにはケンバーンズは適用されません。 クリップはそれ自身の動きを提供し、実際の動きの上にスケールランプを重ねると、まさにそれがストック素材をストック素材と読ませるものです。静止画は動きがなく、生き続けるためにドリフトが必要です。クリップには必要ありません。
// Bロール。全画面、lower third はそれが何かを示し、フレームにソースはありません。
{ "kind": "clip", "from": "everything is moving at once", "dur": 3.0,
"src": "broll/cut-data-flow.mp4", "caption": "Everything moving at once" }
// 引用。視聴者が証拠として読む文書なので、カードとクレジットが戻ります。
{ "kind": "photo", "full": false, "from": "the pricing page changed", "dur": 3.2,
"src": "assets/pricing.png", "caption": "Anthropic pricing, Aug 2026",
"credit": "ANTHROPIC.COM · FETCHED 2026-08-13" }
lower third は cap_left / cap_bottom に配置され、デフォルトは 96 / 186 — ランドスケープ で、youtube_long の左96、下132をクリアします。9:16の呼び出し元は独自の cap_bottom を渡す必要があります。リールは下部に520を予約し、カラオケバンドは y 1150-1400 を占めるため、ランドスケープのデフォルトではキャプションがプログレスバーの下に配置されます。両方のフレームで正しいペアはありません。
src は仕様ファイルからの相対パスで解決され、ビルダーはそれをプロジェクトの assets/ にコピーします。そのため、間違ったパスは空のカードとしてではなく、ビルド時に大きく失敗します。両方とも scripts/fetch_stock.py から取得します。このスクリプトは貼り付け可能なブロックを出力します。
帰属表示はフレームの義務ではなく、台帳の義務です。 すべてのティア3アセットは、ドロップの _FINAL/ATTRIBUTION.md に行を取得します。これは fetch_stock.py がダウンロード時に書き込みます — それが config/broll-policy.md で要求されていることであり、オプションではありません。クレジットがフレーム上にも表示されるかどうかはデザインの決定であり、Bロールの場合は答えはノーです。引用カード上では残り、WCAG AA でレンダリングされ、誰も読めない帰属表示は帰属表示ではありません。
すべての画像は最初にティア順に解決します。写真はティア3です:自分自身のフッテージとティア2のオーバーレイの両方が本当に何も提供しない場合にのみ手を伸ばします。ケンバーンズは、クリッピングカード内の <img> 上で実行され、カード自体では実行されません。
⚠ 長いサードパーティ製ビデオの挿入パターンをコピーしないでください。 この言語の元となったリファレンスは、誰か他の人のインタビューフッテージを50秒間流します。config/broll-policy.md はそれを完全に禁止しており、どんなに優れたモーションデザインでもそれを私たちのものにはしません。帰属表示付きの写真は問題ありません。動画の半分を持ち上げることは許されません。
より広いメニュー — 上記のどれも適合しない場合に手を伸ばすもの
2つの上流コーパスが存在し、どちらもこのライブラリより大きいです。モーションを発明する代わりにこれらから読み取ります。
hyperframes-animation スキル — 48の原子ルール + 22のシーンブループリント。Skill(hyperframes-animation) でロードし、rules-index.md を開き、rules/<name>.md で必要なルールを1つ読みます。ハウスのデフォルトは一時停止した1つのタイムライン上で2~4の原子ルールを合成することです。ブループリントは、4~5フェーズのショット全体が必要な場合に使用します。
ブロックレジストリ — 373のインストール可能なブロック:npx hyperframes catalog --query "<concept>"、次に npx hyperframes add <block>。
状況 → ルール
トーキングヘッドの解説者向けに厳選されています。これらは私たちのフォーマットに耐えるルールです。残りの48のルールは主に製品UIや、私たちが持っていないドリブンカーソルを想定しています。
| 行が…の場合 | ルール | 適合する理由 |
|---|---|---|
| 数字、統計、パーセンテージ | counting-dynamic-scale、stat-bars-and-fills | すでに countup として実装済み。バー、リング、星の塗りつぶしにはルールを直接使用 |
| パンチの効いたリスト、連射 | kinetic-beat-slam、waterfall-entry | beats として実装済み。waterfall-entry はより穏やかなカスケード |
| 定義や用語の定着 | gradient-text-sweep、depth-scatter-assemble | 前者ではグリフは決して移動しない。後者は奥行きからグリフを組み立てる |
| 「これが形状です」(図) | svg-path-draw | 輪郭が自動描画される。セットアップ時に getTotalLength() で測定 |
| 「囲まれている / 埋もれている / 接続されている」 | radial-surround、avatar-cloud-network、orbit-3d-entry | surround として実装済み。残りの2つは接続線と3Dエントリを追加 |
| あるアイデアが別のアイデアに取って代わる | scale-swap-transition、card-morph-anchor、morph-swap | swap として実装済み。card-morph-anchor はコンテナ自体を変形 |
| 「これを詳しく見る」 | depth-of-field-blur、coordinate-target-zoom、viewport-change | ラックフォーカス、または .world ラッパー上の仮想カメラ |
| 話し言葉の強調 | asr-keyword-glow、css-marker-patterns | 単語のタイムスタンプに同期したグロー — すでに測定された単語時間を持っている |
| ハードで打楽器的なアクセント | chromatic-glitch、particle-burst、motion-blur-streak | 控えめに使用。動画あたり最大1回 |
| 落ち着いた着地ビート | titlecard-reveal(ブループリント)、ambient-glow-bloom | 低モーションがペイロードであり、欠陥ではない |
| あらゆる入場 | spring-pop-entrance | 標準的なポップ。迷ったらこれ |
知っておく価値のあるブループリント
22のブループリントのほとんどは製品ローンチの広告形状です。4つが私たちが実際に作るものに対応します。
kinetic-type-beats— 主力。言葉がショットを運び、セットもサーフェスもない。dataviz-countup— データが議論を運ぶ場合。comparison-split— 2つの機能を同時に比較する(私たちのcompareシーンは平坦ないとこ)。titlecard-reveal— ブレーサービート、ちょうど1つの抑制された動き。
スキップ cursor-ui-demo、device-surface-showcase、cta-morph-press、prompt-type-submit-generate およびデモファミリーの残りは、実際に製品UIを表示している場合を除きます。これらは優れていますが、私たちのフォーマットではありません — 突然偽のアプリアプリデモを行うトーキングヘッドの解説者は広告のように読めます。
すべての上流ルールが想定する契約
コピーする前に知っておく価値があります。これらに違反してもチェックは失敗しません — レンダリングが失敗します。
window.__timelines上の1つの一時停止したGSAPタイムライン。自動再生は禁止、2番目のタイムラインは禁止。- 双方向にシーク安全 — 明示的なfrom状態、絶対値を持つ
fromTo、相対+=は禁止。状態はタイムライン時間の純粋関数でなければなりません。 - 決定論的 —
Math.random()やDate.now()は禁止。インデックス派生の擬似乱数のみ。有限回の繰り返し、repeat: -1は禁止。 - Transformとペイントのみ。
width/height/top/leftのトゥイーンは禁止。scale/translateプロキシまたはマスクを使用。 - グループの間隔は、到着が1つのビートとして読まれるように制限 —
items × stagger ≤ ~0.5s。 - レイアウト定数を事前計算。 トゥイーン時に位置を導出しないこと。レンダラーは並行してサンプリングし、測定が同期しなくなります。
新しいコンセプトの追加
- まずレジストリを検索 —
npx hyperframes catalog --query "<concept>"。373のブロックが存在します。radial-surround、morph-swap、split-tilt-cards、particle-image-revealはこのライブラリのものといとこ関係にあり、新しいコードよりも良い出発点になるかもしれません。 - 上記の5つの要素から構築します。6番目の要素を必要とするコンセプトは、シーンであるか、語彙の意図的な拡張が必要であることの兆候です — 例外ではありません。
scripts/stingers.pyのKINDSに追加します。- ギャラリーをレンダリングし、それらすべてを一緒に見ます。それが新しいものがファミリーに加わったか、単に隣に置かれたかを判断する唯一の方法です。
python3 scripts/build_stinger_gallery.py <out> --photo <image>
cd <out> && npx hyperframes check
python3 scripts/probe_frames.py <out> --plan --grid sheet.png
このライブラリがすでに捕捉した3つの不具合
それぞれ、誰かがフレームを見る前にクリーンな hyperframes check を通過しました。
- GSAPは
::afterをアニメーション化できません。querySelectorでターゲットを解決しますが、これは疑似要素を決して返さないため、すべてのシーンが静かに何もしませんでした。シーンは現在、実際の子要素(SHEEN_EL)になっています。カードを追加する場合は、その中に入れてください。 - **GSAP r
…
[truncated for translation]