Communitygithub.com

モーションランゲージ

エージェントが「モーションランゲージ」を計画・構築・編集し、具体的な出力を実用的なコピーやスクリプトにする方法を示します。新しいタスクでこの技術が必要な場合に使用します。

モーションランゲージ とは?

このスキルは、映像制作におけるモーション言語(動きの言語)を体系的に定義し、AIエージェントが一貫性のあるアニメーションやビジュアルストーリーテリングを生成できるようにするものです。特に、シーン(scene)とスティンガー(stinger)の本質的な違いを明確に区別し、スティンガーは視聴者がすでに聞いたアイデアを強調するための短い(2~4秒)視覚要素であり、シーンは新しい情報を伝えるために読ませる必要がある長めの(8~15秒)要素であると定義します。この誤解が一般的な失敗であると指摘しています。さらに、5つの基本要素(グラウンド、ガラス、シーン、パス、ステート)からなる語彙を提供し、それらを組み合わせてconverge、overload、steps、swap、countup、beats、surround、photo、clipの9種類のスティンガーライブラリを構成します。また、Bロール(full-bleed、クレジットなし)と引用(カード内、クレジットあり)の明確な使い分け、ハイパーフレームアニメーションの48の原子ルールや373のブロックレジストリとの連携方法、新しいコンセプトの追加手順、そして既に発見された3つの不具合(擬似要素のアニメーション不可やタイムラインリセット問題など)についても詳細に解説しています。主にClaude Codeやコードエージェントでの使用を想定し、コマンドラインでの実行とJSONベースの仕様記述を前提としています。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lucasaerb/workless-video-editor/tree/HEAD/skills/motion-language

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

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

ドキュメント

モーションランゲージ は何をしますか?

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
beats3つの短いフレーズ、打楽器的。それぞれが共有のビートグリッド上で異なる入場を得ます。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 はフッテージです。ファイル拡張子で分岐するため、名前は仕様を読みやすくするためにのみ存在します。実際に変わるものは次のとおりです。

photoclip
要素<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-entrybeats として実装済み。waterfall-entry はより穏やかなカスケード
定義や用語の定着gradient-text-sweep、depth-scatter-assemble前者ではグリフは決して移動しない。後者は奥行きからグリフを組み立てる
「これが形状です」(図)svg-path-draw輪郭が自動描画される。セットアップ時に getTotalLength() で測定
「囲まれている / 埋もれている / 接続されている」radial-surround、avatar-cloud-network、orbit-3d-entrysurround として実装済み。残りの2つは接続線と3Dエントリを追加
あるアイデアが別のアイデアに取って代わるscale-swap-transition、card-morph-anchor、morph-swapswap として実装済み。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。
  • レイアウト定数を事前計算。 トゥイーン時に位置を導出しないこと。レンダラーは並行してサンプリングし、測定が同期しなくなります。

新しいコンセプトの追加

  1. まずレジストリを検索 — npx hyperframes catalog --query "<concept>"。373のブロックが存在します。radial-surround、morph-swap、split-tilt-cards、particle-image-reveal はこのライブラリのものといとこ関係にあり、新しいコードよりも良い出発点になるかもしれません。
  2. 上記の5つの要素から構築します。6番目の要素を必要とするコンセプトは、シーンであるか、語彙の意図的な拡張が必要であることの兆候です — 例外ではありません。
  3. scripts/stingers.py の KINDS に追加します。
  4. ギャラリーをレンダリングし、それらすべてを一緒に見ます。それが新しいものがファミリーに加わったか、単に隣に置かれたかを判断する唯一の方法です。
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 を通過しました。

  1. GSAPは ::after をアニメーション化できません。 querySelector でターゲットを解決しますが、これは疑似要素を決して返さないため、すべてのシーンが静かに何もしませんでした。シーンは現在、実際の子要素(SHEEN_EL)になっています。カードを追加する場合は、その中に入れてください。
  2. **GSAP r

…

[truncated for translation]

Individual skills in this repo

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

関連スキル