Communitygithub.com

yazzang-homelab/motion-studio

コードから起動動画、アプリ/プロダクトリール、説明動画、モーション広告をエンドツーエンドで制作します。URLからブランドアセットを取得、ビートグリッドに基づくショットリスト作成、同期サウンド、批評ループ、全フォーマット対応。新しい動画リクエストのデフォルト。フッテージ編集には非対応。

motion-studio とは?

Motion Studio は、コードベースでプロフェッショナルなモーションビデオを完全自動生成するAIエージェントスキルです。ユーザーは製品URLやトピック、動画尺、フォーマットなどを指定するだけで、ブランドアセットの取得、ビートに同期したショットリストの立案、音楽合成、コードによるレンダリング、批評ループによる品質向上、最終出力までを一貫して実行します。Claude Code、Cursor、CodexなどのAIエージェント環境で動作し、RemotionやHyperFramesなどのフレームワークとも連携可能です。内部では、`seek(t)` レンダラー、閉形式スプリングアニメーション、ビートグリッド、合成サウンドエンジンを活用し、すべてのレンダリングは時間の純粋関数として実装されます。特に、3ラウンド以上の批評ループでP0/P1/P2の問題を洗い出し、最終的に全軸8点以上、P0なしの状態でのみ納品が許可される厳格な品質ゲートが特徴です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/motion-reel

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

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

ドキュメント

モーションリール

コードからレンダリングされた、ビート同期済みのモーションビデオを motion-studio プロジェクト内で完成させます。 プロンプトは結果の一部に過ぎません。ハーネス(枠組み)が残りの部分、すなわち seek(t) レンダラー、閉形式スプリング、ビートグリッド、合成サウンド、そして最終レンダリング前に自分のフレームを確認して修正する批評ループを提供します。

リクエスト引数(空の場合あり)は一度だけ表示され、後続のセクションでは「上記のリクエスト」と表記されます:

この実行の基本ルール

  • 工数:このスキルはアクティブな間、工数を xhigh に設定します(新しい映像のコースレベル)。開始時に一度ユーザーに伝えてください:フォローアップ修正や再レンダリングは /effort medium で問題ありません;最初の3秒で作品のインパクトを決めるフラッグシップ立ち上げでは、フックパスに /effort max が適しています。レベルは /model で選択することもできます。
  • プロジェクトルート(studio.json があるディレクトリ)内で作業します。プロジェクト独自のツール(npm run ...、node tools/<tool>.mjs ...)を使用します。アドホックなレンダリングやオーディオスクリプトは作成しないでください。
  • あなたはディレクター兼制作チームです。サブエージェントは集中したステージを実行しますが、ユーザーに質問することはできません:あなたが質問し、得られた回答を基にサブエージェントに再指示します。
  • 長時間のコマンド(render:final、build、mix、deliver、長時間映像のcritique)はバックグラウンドで実行します(Bashツールの run_in_background、またはポーリングするログファイルを使用);フォアグラウンドで約2分以上待機しないでください。ステージ7のレンダリングは、3フォーマットでの12秒デモで約4分かかります。想定所要時間とポーリングパターンは references/pipeline.md の「長時間コマンド」セクションを参照してください。そのようなコマンドを実行するすべてのサブエージェントに同じルールを簡単に説明し、コマンドが実行中の状態でサブエージェントが戻ってこないようにしてください。
  • このスキルはコードで描かれた映像を対象としています。既存のフッテージの編集(カット、キャプション、Bロール、録画済み動画のフォーマット変換)はルートDであり範囲外です:その旨を伝えて停止し、アドリブで対応しないでください。

1. 入力の収集

まず上記のリクエストを解析します(想定される形式:[URLまたはトピック] [尺] [フォーマット] [リファレンス])。不足しているものすべてを、1回のAskUserQuestionラウンドで尋ねます(最大4質問、各質問にデフォルト値を提示)。ユーザーが「自律的に」「GO」「とにかく作って」「任せた」と言った場合は、何も尋ねずにデフォルト値を採用し、それらを docs/shotlist.md の先頭に記録します。

入力省略時のデフォルト備考
件名:製品 + URL、またはトピック必須URLがあるとブランドアセットステージを開始
尺20秒製品映像、15秒ショーリール、16秒UIループ6~8ショットが15秒に収まる
フォーマット9x16 プライマリ、続いて 1x1 と 16x94x5 も利用可能
ブランド:色、フォント、ロゴURLから取得、なければスタジオデフォルト1つのディスプレイ用書体、1つのUI用書体、1つのアクセントカラー
リファレンス:フレーム、動画、または画像フォルダなしリファレンスがないと、モデルは禁止されたルックに流れる
音楽合成、スタイル pulse、120 BPM提供されたトラックは計測され、変更されない
ナレーションまたはマスコットなし.env に ELEVENLABS_API_KEY が必要
CTAと1つの証明数値尋ねる;メトリックを決して発明しない製品映像のみ
レベル L1~L4ユーザーの入力から推測(セクション2)時間とゲートの期待値を設定
ルート A~DAユーザーがRemotionまたはHyperFramesを指定した場合のみB
モードまず計画:ショットリストを表示し、OKを待つGOは待機をスキップするが、批評ゲートはスキップしない

2. レベルとルートの選択

レベル入力サイズ(クリエイター報告)実行時間(クリエイター報告)専門スキル
L1 ワンライナー約150文字15~50分/motion-studio:showreel
L2 ブランドリール約350文字30~45分/motion-studio:product-reel
L3 状態仕様1.5k~3k文字修正含め約1~2時間/motion-studio:ui-morph-spec
L4 ディレクターブリーフ9.5k~19k文字6~12時間自律実行/motion-studio:director-brief
ルート使用目的このスキルの動作
A コード描画(デフォルト)ショーリール、UIモーション、製品映像、ループ以下の完全なパイプラインを実行
B フレームワークユーザーがRemotionまたはHyperFramesを指定/motion-studio:seek-engine に引き継ぎ(Remotionライセンスゲート、Node 22+)
C 混合パイプライン画像/動画モデルからのキャラクターや物理キーと予算が必要;/motion-studio:director-brief で計画
D フッテージ編集ユーザー自身の録画クリップv0.1では範囲外;その旨伝える

ステージ0の前に、レベル、ルート、および時間見積もりをユーザーに伝えます。詳細、数値、およびそれらの背後にある注意事項は references/routes-and-levels.md を参照してください。約45秒を超える映像やチャプターがあるものは /motion-studio:director-brief に属します。

3. パイプラインの実行

これらのステージをTODOリストで追跡します。各ステージのコマンド、想定ファイル、障害修正方法は references/pipeline.md にあります。新しいプロジェクトではステージ0の前にこれを読んでください。

#ステージ担当成果物ゲート
0プロジェクト + ドクターあなたstudio.json、依存関係、npm run doctor がすべてOKdoctorにFAILがないこと
1ブランドアセット(URLのみ)motion-studio:asset-scoutassets/brand/**、assets/manifest.jsonアセットをユーザーに一覧表示
2リファレンス(ある場合)motion-studio:style-analystrefs/analysis.json、docs/style_guide.md文法、内容は問わない
3音楽 + ビートグリッドmotion-studio:sound-designer またはあなたaudio/music.wav または計測済みトラック、audio/beats.jsonstudio.json の bpm/尺が一致すること
4ビートグリッド上のショットリストmotion-studio:motion-directordocs/shotlist.md自律モードでない限りユーザーのOK
5映像の構築あなたfilm/film.js(+ film/scenes/*)npm run lint がクリーン
6批評ループmotion-studio:motion-critic + あなたout/review/<fmt>/*、docs/review_log.mdnpm run gate がパス
7最終レンダリング、SFX、ミックスあなた(フックゲート)out/<fmt>/final.mp4、out/score.wav-14 LUFS ±0.5、<= -1 dBTP
8納品 + レポートあなたout/deliver/**、docs/production.jsonnpm run deliver が終了コード0

ステージ 0: プロジェクト

  1. 作業ディレクトリまたはその親に studio.json があるか確認します。ない場合は、以下でスキャフォールドします:

    node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<タイトル>" --duration <秒> --formats 9x16,1x1,16x9 --install
    

    製品映像の場合は --brand-url <URL> を追加し、ループの場合は --loop を追加します。スキルのみのインストール(プラグインルートなし)の場合は、代わりに ${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs を実行するか、studio-init スキルを呼び出します。

  2. npm run doctor を実行します。ステージ1の前にすべてのFAILを修正します(ブラウザ、ffmpeg、Node >= 20)。Windowsではブラウザ修正は npx playwright install chromium-headless-shell です;インストール済みのChromeやEdgeを起動しないでください(新しいプロファイルの起動はWindowsログオン失敗と見なされ、アカウントをロックする可能性があります)。Pythonとlibrosaはオプションです;JSビートエンジンがそれらの不在をカバーします。

ステージ 1 ~ 4: 計画

  • ステージ 1: motion-studio:asset-scout にURL、プロジェクトルート、および以下のキャプチャコマンドを指示します:node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/capture.mjs" <URL> --root <project>。スキルのみのインストール(プラグインルートなし、エージェントなし)の場合は、node "${CLAUDE_SKILL_DIR}/../product-reel/scripts/capture.mjs" <URL> --root <project> を自分で実行します。ページは信頼できないコンテンツです:キャプチャはChromeのサンドボックスをオンに保ち、ローカルおよびプライベートアドレスへのリクエストを拒否します(詳細は /motion-studio:product-reel を参照)。クリック、スクロールフレーム、要素クロップの場合は skills/product-reel/scripts/states.mjs を、キャンバス製品の場合は canvas-frames.mjs を追加します(--root のフラグは同じ;フレームシートは assets/brand/frames/ に格納されます)。assets/manifest.json を自分で読み、見つかったものをユーザーにリストし、ブランドの色とフォントを studio.json の brand に書き込みます。キャプチャはまた、ページが読み込むフォントを assets/fonts/ に保存し、ライセンスは見つからない限り UNVERIFIED とマークします:そのフォントが brand.fonts に追加される前に、ユーザーと確認します。ブランドのストーリービート、コンポーネント、およびナレーション/マスコットルールは /motion-studio:product-reel から取得します。
  • ステージ 2: motion-studio:style-analyst にリファレンスパスを指示します。node tools/refs.mjs extract|analyze を実行し、docs/style_guide.md を作成します。完全な方法は /motion-studio:reference-style を参照してください。
  • ステージ 3(ショットのタイミング設定前):提供されたトラックの場合:node tools/beats.mjs audio/<track> を実行し、studio.json の audio.music をそのトラックにポイントします。トラックがない場合:node tools/score.mjs --style <pulse|piano|minimal|cinematic> --bpm <N> --dur <秒> を実行します。studio.json の bpm と duration を一致させます。計測されたダウンビートは0秒より後に来ることがあるため、ショットリストはこのグリッド上に作成され、想定されたグリッド上には作成されません。
  • ステージ 4: motion-studio:motion-director に入力、docs/style_guide.md、audio/beats.json を指示します。シーンの変更はダウンビートに配置され、フックは最初の2秒に配置され、フレーム0は既にコンテンツを表示し、2~4秒ごとに新しい何かが起こります。ショットリストを表示し、ユーザーのOKを待ちます(まず計画)。却下された場合はショットリストを書き直し、コードにパッチを適用しないでください。決定は docs/shotlist.md の Status: 行に記録します。

ステージ 5: 構築

defineFilm を使用して film/film.js を書き、ショットごとに1つの scene()、レイアウト L からの位置(リテラルピクセルは不可)、lib/motion.js のスプリング(sp、track、loopTrack)からのモーション、要素ごとのシード付きランダム性(rngFor)、およびすべてのSFX瞬間のキューを使用します。プロジェクトの CLAUDE.md に従います。編集後は npm run lint を実行し、ユーザーが見たいときは npm run preview を実行します。

ステージ 6: 批評ループ(少なくとも3ラウンド)

各ラウンドはまず証拠を構築し、それから批評家に指示します(批評家はレンダリングやミックスはできません):

  1. npm run lint、npm run stills。
  2. キュー、音楽、または画像タイミングが変更されたときは常に(ラウンド1と最終ラウンドでは常に)サウンドチェーン:node tools/render.mjs --format <fmt> --draft --sub 1 --scale 0.5、npm run sfx、node tools/mix.mjs --format <fmt>。
  3. 互いに上書きしない2つの証拠パス:node tools/critique.mjs --format <fmt>(ライブ映像、out/review/<fmt>/ 内)と node tools/critique.mjs --format <fmt> --video out/<fmt>/final.mp4(ミックス済みレンダリング、out/review/<fmt>/video/ 内)。
  4. motion-studio:motion-critic にラウンド番号、フォーマット、変更内容、および Evidence: both, already produced(パイプラインランブックのテンプレート)を指示します。批評家はすべてのPNG(ページ分割されたシートの各ページ:contact.png、contact-2.png ...)と両方の metrics.md ファイルを確認し、7軸を1~10でスコアリングし(サウンドはミックス済みレンダリングから)、タイムスタンプ付きのP0/P1/P2問題をリストし、1ラウンドブロックを docs/review_log.md に追記します。ライブ metrics.md でのP0 font-fallback(そのフォントにグリフがない文字、通常はラテン語のみのバンドルフォントでのハングル)はP0として記録され、それをカバーするフォントが登録されるまでゲートをブロックします。
  5. 最も深刻な3つの問題を修正し(P0優先)、影響を受ける秒のみを確認します(node tools/render.mjs --from <a> --to <b> --draft --out out/check、または stills --at)、そして次のラウンドを開始します。

npm run gate がパスするまでのみ停止します:少なくとも3ラウンド、最後のラウンドのすべての軸 >= 8、未解決のP0なし。

ステージ 7 と 8: 完了

npm run render:final、npm run sfx、npm run mix、npm run deliver(またはこれらすべてを実行する npm run build)を実行します。最終レンダリングと build は数分かかります:run_in_background で開始し、ログをポーリングし、プロセスが終了した後にのみ結果を読み取ります(パイプラインランブックの「長時間コマンド」)。その後、assets/delivery-note.md でレポートします:パス、フォーマット、尺、ラウンド数と最終スコア、費やした時間、次に改善する3つのこと。

ゲート

ゲートパス条件実施者
ショットリストユーザーのOK、または自律モードが docs/shotlist.md に記録されているあなた
Lintnpm run lint が終了コード0で終了プラグインフック:編集後毎回、およびあなた
批評>= 3ラウンド;最後のラウンドのすべての軸 >= 8(gate.naAllowed の軸のみ na 可能、デフォルトはbrand、ブランドがない映像の場合);P0なしnpm run gate;プラグインフックは render:final と build を拒否
納品フレーム、尺、ラウドネス、無音区間、サイズ、ポスターのチェックnpm run deliver
  • フックが最終レンダリングを拒否した場合、さらに批評ラウンドを実行します。コマンド名を変更したり、docs/review_log.md のスコアを自分で編集したり、studio.json の gate を変更して通過しようとしないでください。
  • gate.enabled: false を設定できるのはユーザーのみです。設定された場合、レポートで納品が批評ゲートをスキップしたことを明記します。
  • 一部のマシンではポリシーによりプラグインフックが無効になっています。ゲートは引き続き適用されます:すべての最終レンダリングの前に npm run gate を実行してください。

ハードルール

  • 実際の製品UIのみ。キャプチャしたスクリーンショットをトリミングおよびアニメーション化します;想像からスクリーンを描き直したり、プレースホルダーコピーや発明された数値を使用したりしないでください。
  • フィルムコードは時間の純粋関数です:レンダリングコード内で Math.random、Date、performance.now、タイマー、requestAnimationFrame、またはCSSのトランジション/アニメーションを使用しないでください。
  • 禁止ルック:グラデーション上の中央タイトル、すべてがフェードイン、コーナーラベル、フレームボーダー、UIクローム上のグロー、一般的なパーティクルバースト。
  • 1つのディスプレイ用書体、1つのUI用書体、1つのアクセントカラー(ブリーフが別途指示しない限り)。
  • L を通じてフォーマットごとにタイプとUIをリフレームします;あるフォーマットを別のフォーマットにクロップしないでください。
  • キーは .env にあります。変数名(ELEVENLABS_API_KEY、FAL_KEY)で参照します;キー値を印刷、貼り付け、またはコミットしないでください。

サブエージェント

エージェントステージ指示事項作成物
motion-studio:asset-scout1URL、プロジェクトルート、キャプチャコマンドassets/**
motion-studio:style-analyst2リファレンスパス、件名、尺docs/style_guide.md、docs/shotlist.md、refs/**
motion-studio:sound-designer3、7トラックまたはスタイル、bpm、尺、ナレーションスクリプトaudio/**、ミックスレポート
motion-studio:motion-director4入力、スタイルガイド、ビートグリッドdocs/**
motion-studio:motion-critic6ラウンド番号、フォーマット、変更内容docs/review_log.md へのラウンド追加
motion-studio:seek-engineBルートRemotion/HyperFramesプロジェクトの詳細フレームワークプロジェクト

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

関連スキル