Communitygithub.com

oHad6k/emulo

概要を映画に変えるスキル。1行のリクエストを、animations-v3エンジン独自の言語で記述されたClaude Designプロンプト、構築済みのpiece.jsx、そしてレンダリング前に確認できるコンタクトシートに変換します。リファレンスの役割、キット、ストーリーボードのゲート、モーションフロア、検証コマンドをカバーします。バックエンド作業、UIデザイン、単独のマーケティングコピーには使用しないでください。

emulo とは?

Emuloは、与えられた簡単なブリーフ(概要)から、Claude Designで実際に使用可能な映画制作プロジェクトフォルダを生成するAIエージェントスキルです。このスキルは、単なるプロンプトの提案に留まらず、プロンプトファイル(PROMPT.md)、アップロード手順(START-HERE.md)、必要なアセット(ATTACH/)、リファレンスフレーム(frames/)、そして全ファイルのマニフェスト(KIT.md)を含む完全なフォルダ構造を構築します。主にClaude CodeとClaude Designの連携を前提としており、前者がキットを構築し、後者がアニメーションを実行するというパイプラインを採用しています。animations-v3.jsxというCompositionランタイムをベースに、リファレンスの平均化禁止、アセットの実在確認、段階的な構築と検証など、高品質な映像制作を実現するための厳格なルールが定義されています。バックエンド開発や一般的なUIデザインには使用せず、映像制作に特化したスキルです。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ohad6k/emulo/tree/HEAD/skills/video

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

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

ドキュメント

Emulo video

あなたはブリーフを受け取り、映画を返します。プロンプトではなく、映画です。それを構築したプロンプト、コンポジションファイル、そして誰かが見ることができるフレームを返します。

0. 何かを書く前にプロファイルを読み込む

  1. このスキルの2つ上のディレクトリにある emulo.py を見つけます。直接リポジトリをチェックアウトした場合のみ ./emulo.py にフォールバックします。
  2. 解決された絶対パスを EMULO_PY として保存し、python "$EMULO_PY" plugin profile-path --domain video を実行します。
  3. 終了コードが0以外の場合、その正確な回復手順を表示し、個人コンテキストの読み込みを停止します。汎用的なクリエイティブペルソナに代用してはいけません。
  4. 返されたすべてのパスを完全に読み込みます。最初はコアワーキングプロファイル、次がビデオプロファイルです。どちらも以下のすべてより優先されます。個人のマイニングされたルールがこのスキルのデフォルトと矛盾する場合、個人のルールが優先されます。
  5. プロジェクトに独自のビデオドキュメントやルーターがある場合は、それらを最初に読み、それらがカバーするすべての事項についてそれらに従います。

1. あなたが返すもの

ユーザーがClaude Designにアップロードして映画を取得できるフォルダ。 それが成果物です。チャットメッセージ内のプロンプトでも、映画の説明でも、アイデアのリストでもありません。フォルダです。

プロジェクト内に、ブランド名または映画の名前を付けたフォルダに、以下の形で構築します。

#アーティファクト存在理由
1PROMPT.mdブリーフ。1ページ、エンジンの言語で記述
2START-HERE.mdアップロード順序。 どのファイルを、どの順序で、1つのメッセージで。これがないとユーザーは推測し、その推測は間違っています
3ATTACH/映画に必要なすべてのアセット(animations-v3.jsx 自体を含む)
4frames/ファイル名に指示が含まれているリファレンススチル
5KIT.mdマニフェスト:すべてのファイル、そのピクセルサイズ、既知の欠陥

オプションで、上記5つが完了した後に限り:build/piece.jsx と build/frames/。これは映画をローカルで構築・レンダリングし、他の誰よりも先に確認できるようにするものです。これは検証であり、成果物ではありません。ローカルビルドがないキットでも出荷できます。キットがないローカルビルドは出荷できません。

フォルダが機能するかどうかを決定する3つの要素

ATTACH/ 内にエンジンを同梱すること。 animations-v3.jsx はアセットと一緒にフォルダに入れます。Claude Designは、記述を依頼されているランタイムを必要とします。これを省くと、良いプロンプトが悪い映画を生む一般的な原因になります。

分離されたパーツ、画面全体のスクリーンショットは不可。 ファイルごとに1つのオブジェクト、透明、長辺最小1600px、さらに地面用に映画のアスペクト比に合わせた大きなプレート。ドロップされた画面全体はスラブであり、壊れていると見なされます。この方法で構築された映画は、プロンプトの長さよりも、アセット不足で失敗することがはるかに多いです。

ファイル名に指示を入れること。 REF_03_object-becomes-the-mark.png は教えますが、ref3.png は教えません。アップロードするユーザーは名前をそのまま保持するため、すべてのファイルが独自の教訓をコンテキストに持ち込みます。

欠落しているものに名前を付け、代用物を決して発明しないこと

アセットが存在しない場合は、PROMPT.md に独自の見出しの下でその旨を明記し、代わりに何をすべきかを記述します。2つの欠落アセットを認めるブリーフは使用可能です。静かに偽造するブリーフは、2つの壊れたビートを含み、その理由を特定できない映画を生成します。

すべてのプロンプトには、以下の順序で名前を付けて含めること

  1. エンジンの言語でのブリーフ:OM_SCENES、CUES、名前付き Easing
  2. マッチアンカーとしての変換チェーン:何が何になるか
  3. アセットリスト(実際のファイル名付き)により、欠落パーツが原因でビートがブロックされないようにする
  4. この特定の映画の障害条件(汎用的なものではない)
  5. 検証コマンド。これにより「動作する」という主張に出力が伴う

2. エンジン

animations-v3.jsx はClaude Designのコンポジションランタイムです。そのヘッダーを一度読んだら、このテーブルに従って作業します。

animations-v3.jsx を編集してはいけません。 そのヘッダー自体に、copy_starter_component を再実行すると上書きされると記載されているため、そこで行われたすべての変更は次のホストコピーで失われます。レバレッジはブリーフにあります。

使用するもの使用しないもの
Easing.easeOutExpo および名前付きカーブcubic-bezier(...)、あらゆるCSS文字列
dur を持つ名前付きセクション OM_SCENES構造としての絶対フレーム番号
コレオグラフィーをキーとする CUES.SectionName実時間、setTimeout、requestAnimationFrame
animate({from, to, start, end, ease})(T)可視要素を描画する useEffect
interpolate([...], [...], ease)(T)単独で実行されるCSSキーフレーム
ハードカットのための <Shot from to>セクションごとの条件付きマウント
唯一のエクスポート可能ルートとしての1つの <CompositionStage>他の場所でのエクスポート可能属性

一文でのモデル:アニメーションは、1つのオーサリングされた時間軸の純粋関数としてレンダリングされる1つの要素ツリーであるため、セクション境界で何もマウントまたはアンマウントされず、任意のオブジェクトが通常の補間によって映画全体にわたって持続、移動、または変形できます。これにより、ブリーフが苦労して求める必要があるものではなく、ゼロカットと1つのオブジェクトが映画全体で変形することがエンジンのデフォルトになります。

<CompositionStage width={1080} height={1920} bg="#161309"
                  scenes={window.OM_SCENES} playback={window.OM_PLAYBACK}>
  <Piece />          // ONE component, the whole film
</CompositionStage>
useComposition() -> { T, CUES, time, duration, authoredTotal, playing }

OM_SCENES と OM_PLAYBACK は、メインドキュメントのプレーンなインライン <script> タグ内のJSON文字列リテラルであり、type="text/babel" ではなく、そのまま渡されます。すべてのエントリには desc(1つのプレーンな文)が必要です。これはユーザーがタイムラインポップオーバーで読むためです。nat を手動で設定してはいけません。

<script>window.OM_SCENES = '[{"name":"Strike","dur":2.5,"desc":"The mark lands and throws colour across the ground"}]';</script>
<script>window.OM_PLAYBACK = '{"mode":"loop"}';</script>

イージング、完全なリスト。 linear;easeIn/easeOut/easeInOut(Quad、Cubic、Quart、Expo、Sine 用);easeInBack、easeOutBack、easeInOutBack;easeOutElastic。Back と Elastic はオーバーシュートするため、ロゴや公式ブランドファイルの近くには置かないでください。

T からのみレンダリングすること。 エクスポーターは同期コミットで各フレームをシークし、シークが戻った瞬間にステージをシリアライズする可能性があるため、エフェクトやプライベートアニメーションループから描画されたものは古い状態でエクスポートされます。

キャプションは要求された場合のみ。 ブリーフまたはユーザーのビデオプロファイルが焼き込みキャプションを要求した場合にのみ、<Captions> をレンダリングします。多くのユーザーは後で独自に追加するため、焼き込みキャプションはそれを台無しにします。画面上に固定されたコピーは、コンポジションが望む場所に配置された通常の要素です。

bg を映画の地面(ground)に設定し、デフォルトの #0b0b0e や #000000 にしないでください。デザインされた世界には、光がフェードアウトする場所が必要です。

正確に3つまたは4つのモーションヘルパーを事前に定義し、それらの外部でイージングやトランスフォームを使用しないでください。

MOTION.slam    Easing.easeOutExpo     arrivals and impacts
MOTION.snap    Easing.easeOutBack     chips landing, overshoot capped at 6%
MOTION.drive   Easing.easeInOutQuart  travel, light, drift
MOTION.settle  Easing.easeOutQuart    the final resolve

3. リファレンスを割り当てる。決して平均化しない

すべてのリファレンスには1つのジョブと明示的なコピー禁止リストを割り当てます。「リファレンスを平均化しない」という行がないと、モデルはスタイルを混ぜ合わせてどろどろにします。

リファレンスその1つのジョブ決して取らないもの
ユーザーがモーション用に指定した映画変形、奥行き、スケールコントラストそのパレット、そのブランド
ユーザーがカメラ用に指定した映画カメラとイージング:イベント、ホールド、セトルその色、その製品
ブランド自身の素材アイデンティティ、タイポグラフィ、正確なマークインターフェースレイアウトをテンプレートとして

これをプロンプトに次の形で記述します。

X を以下の PRIMARY 権威として使用:ペーシング、控えめさ、マッチアンカー、スケール
コントラスト、カメラのプッシュとプル、奥行き、最後のホールド。
Y を以下のためだけに使用:モノクロームのアイデンティティ、タイポグラフィ、正確なロゴ、明瞭さ。

X のデザインをコピーしないこと。X の色を導入しないこと。リファレンスを平均化しないこと。

ユーザーが同じエンジンで完成した映画をいくつか持っている場合、少なくとも3つを読み、それらすべてに共通するものを尋ねます:シーンリストの宣言方法、変換チェーンの表現場所、エントランスとそれがヒットするものとのタイミング、最後の3秒の構築方法。定数がワークフローです。1つだけに存在するものは、その映画の衣装です。

段階的に構築し、間にゲートを設けること。 最初の5~8秒を構築します。レンダリングします。コンタクトシートを見ます。その後でのみ続行します。誰も見る前に構築された20秒の映画は、誰も修正できない20秒の映画です。なぜなら、欠陥はコンセプトにあり、そのコンセプトが今や荷重支持になっているからです。

4. プロンプトを書く前にキットを構築する

実際のアセットがない長く詳細なプロンプトは、テキストの代わりに灰色の長方形と、実際のマークの代わりに手描きの形状が返ってきます。なぜなら、プレースホルダーは、配置する実際のものがない状態でモデルが描画できる唯一のものだからです。

Claude Codeがキットを構築します。Claude Designがそれをアニメーション化します。 その分割がパイプラインです。

  1. リファレンスを1:1で測定します。1ファイル、コンタクトシートは不可。ビート、地面の色、平均輝度、平均彩度、およびフレームを物理的に占めるものを書き留めます。
  2. ブランドの取り込み。 公式マークは通常、ブランド自身のガイドラインまたはプレスページにあり、「こうしないでください」の例と混在しています。明るいものと暗いもののコンタクトシートをレンダリングし、何かに名前を付ける前に見ます。
  3. 製品UIを、実際の文字列を運ぶライブDOMとして再構築し、ヘッドレスブラウザで3倍から5倍のフラットプレートに撮影します。インターフェースは再構築されます。ワールドアートはレンダリングおよびコンポジットされます。何も偽装されません。
  4. 画面ではなくパーツを切り出す。 画面全体はスラブであり、スラブはアニメーション化できず、スライドのみ可能です。1600px以上の孤立した透明オブジェクトの parts/ フォルダを出荷します:すべてのボタン、チップ、ノード、バー、タイル、バッジ、アイコン。
  5. マークを独自のレイヤーに分割します。 公式SVGは、ピクセルパーフェクトに重なるレイヤーに分割されます。検証します:元のものと重ねた場合、任意のピクセルの最大差は255のうち約1であるべきで、これはアンチエイリアシングです。その後、映画はマークにカットするのではなく、マークを組み立てます。
  6. 最適化します。 各ファイルを小さく(数百KB程度)、キット全体を数MBに保ち、Claude Designプロジェクトに持ち込めるようにします。
  7. すべてのファイルを開き、その欠陥を KIT.md に記録します。 クリップされたボタン、アルファの欠落、アスペクトの誤り、白いカードで消える白いエンブレム。見つけたすべての欠陥を、KNOWN KIT DEFECTS(既知のキット欠陥)の下で、映画がそれに対して何をすべきかとともにプロンプトに含めます。何も見つからなかった場合は、すべてのファイルを開いて何も見つからなかったと述べます。

アスペクトは実際の欠陥クラスです。1200x800のチップを224x160のボックスにレンダリングすると、すべてが水平方向に7%伸び、これはレビューを生き残るほど微妙でありながら、すべてのフレームで間違っています。

公開されたアーティファクトは、外部ホストをブロックする厳格なCSPの下で実行される可能性があるため、キット内のものはCDNを指してはいけません。すべてがプロジェクトファイルまたはデータURIです。

5. 最初に OM_SCENES を書く

それはアウトラインであり、セクション名はブリーフの残りの部分が話すキューボキャブラリーになります。6つのセクションは良い映画です。10はスライドショーです。

各 desc は、気分ではなく物理的なイベントに名前を付ける1文です。「三角形がアパーチャになり、カメラがそれを押し抜け、フル製品プレビューに引き戻す」は desc です。「スピードと可能性の感覚」は違います。

6. マッチアンカーとしての変換チェーン

映画を運ぶ1つのオブジェクトに名前を付け、それを壊すことを禁止します。

すべてのシーンは、前のシーンから1つの可視オブジェクト、形状、線、またはモーションベクトルを継承します。絶対に:シーンがフェードアウトし、空の背景、次のシーンがフェードインすることはありません。入ってくるビートは、出て行くビートがまだ25~50%可視である間に可視です。

例えば、ブランドマークである1つの色付き円、次にレッスンノード、次にすべての名前が収束するもの、そして再びマーク。または、すべての製品表面に印刷された1つのトラックタイトルで、同じ曲がバーからデスクトップ、電話へと移動します。

これに伴う色のルール。 公式レイヤーになるオブジェクトは、ブランドの公開された色ではなく、そのレイヤーの色に補正されます。ブランドファイルとブランドガイドラインページはしばしば数値で異なり、ガイドライン値に補正すると、まさに不可視でなければならないフレームで色が変わります。ファイルがガイドラインページより優先されます。

7. プロンプト

これを埋めてください。構造的なものを削除しないでください。長くてファイル名を含まないブリーフは間違ったブリーフです。

あなたは、animations-v3コンポジションエンジン上に構築された、<N>秒の<縦|横>スペックコマーシャルを<BRAND>のために監督しています。シネマティック。少数のオブジェクト、大きく、照明あり。

フォーマット。文字通りに記述すること。

  <CompositionStage width={<W>} height={<H>} bg="<地面の16進数>"
                    scenes={window.OM_SCENES} playback={window.OM_PLAYBACK}>

<W> x <H> のサイズ。コンポジションが<<高さより幅が広い| <W>x<H> でない>場合、他の何かが評価される前に失敗しています。

唯一のルール

画面上のすべてのオブジェクトは、以下のリストからのファイルです。タイムラインは決して<BRAND>の画面を描画せず、マークを描画せず、テキストを灰色の長方形で代用せず、グラデーションで画像を近似しません。それらのファイルを配置、マスク、クロップ、照明、移動します。

ビートにキットに含まれていないオブジェクトが必要な場合は、その旨を述べて停止してください。divで代用しないでください。パスを解決できない場合は、代替品を描画する前に、何かを構築する前に私に伝えてください。

リファレンス

<リファレンスごとに1つのジョブとコピー禁止リスト。次に:それらを平均化しないこと。>

アセット

  <すべてのファイル、そのピクセルサイズ、およびそれが何のためかに関する1行。どの要素レベルのパーツが存在し、それらが単独で何をすることを意図しているかに名前を付ける。>


バーと、それが除外するもの

<ジャンルの除外、クラフトノートではない。ジャンルの除外は、モデルがすでに理解しているものです:6つの切断されたスライド、SaaSプロダクトツアー、ダッシュボードモンタージュ、カンファレンスプレゼンテーション、開発者チュートリアル、ブラウザ画面録画、テクノロジーロゴの壁、ジェネリックな未来的AI広告...
(訳注:原文が途中で切れています).

同じ数のビートであれば、すべてのビートで1つのことを正しく行う映画の方が、3つのことを中途半端に行う映画より優れています。

プロンプトの後にアセットを見たら、存在しないものを特定し、欠落している行を削除します。決して何もでっち上げないでください。

## 8. ストーリーボードゲート

プロンプトが書かれたら、Claude Designに何も渡さず、最初の3つのシーンをレンダリングして静止画を確認します。

**ストーリーボードゲートを通過する**:オブジェクトが存在し、正しいファイルであり、正しいサイズで、正しい場所にあり、正しい色である。

**通過しない**:プロンプトが「製品画面」と言っているが、ファイルがなく、モデルが青い長方形を描画した。または、マークが配置されているが、カラーがブランドガイドラインから取得され、ファイルからは取得されていない。

このゲートに失敗したら、修正します。ファイルを修正します。プロンプトを調整します。再レンダリングします。またゲートします。ゲートを通過するまで完全なレンダリングは行いません。

## 9. モーションフロア

キットがゲートを通過したら、フルレンダリングします。次に、モーションフロアを実行します:映像を最初から最後まで見て、各ビートがヒットするかどうかを確認します。

| チェック | なぜそれが必要か |
|---|---|
| オブジェクトはファイルから来ているか?(画面上のものはキット内のものです) | 最も一般的な破損モード:モデルがファイルを無視し、テキスト用の灰色の長方形を描画する |
| カットは、表示すべきものを表示しているか?( `<Shot from to>` がアセットをまたいで動作している) | 2番目に一般的な破損モード:シーンがフェードアウトしてからフェードインする |
| 最後の3秒は、それが唯一のフレームであっても機能するか? | サムネイルに静止する映画は、最後の秒がなければ売れない |
| テキストは読めるか?少なくとも24ptの高さのxハイト、白または割り当てられた色 | 唯一の設計違反であり、瞬間的に損害を与える |
| ゆっくりとしたパートは退屈か、それともホールドか? | 最も頻繁に誤診される問題:ホールドは意図的であり、退屈はそうではない |

モーションフロアを通過したら、フォルダ全体をユーザーに手渡します。何が入っているか、どのファイルから始めるべきか、どこで停止するかを伝えます。

## 10. 検証コマンド

すべてのプロンプトは、次の形の検証コマンドで終わります。

```text
検証:
  1. `frames/` の各静止画リファレンスに対して、それがプロンプト内の1つの指示と一致することを確認します。
  2. `ATTACH/` の各アセットがプロンプトに記載されていることを確認します。
  3. `PROMPT.md` に対して、OM_SCENESのdescがすべて物理的なイベントであり、気分ではないことを確認します。
  4. Claude Designで一度レンダリングし、すべてのオブジェクトが実際のファイルであり、プレースホルダーでないことを確認します。

関連スキル