Communitygithub.com

motionsnip-studio

モーショングラフィックスをコードで作成し、MotionSnip Studioのローカルプレーヤーで確認・フィードバックを行うスキル。ユーザーが動画のレビュー、反復、編集を効率的に行えます。

motionsnip-studio とは?

MotionSnip Studioは、Remotionなどのコードベースの動画レンダラーと連携し、ローカルプレーヤーによる高速なフィードバックループを実現するAIエージェントスキルです。ユーザーは動画を視聴し、テキストの修正、音楽の差し替え、フレーム上の問題を丸で囲むなどの操作を行い、ワンラインのプロンプトでAIにフィードバックを送信します。このスキルは、動画のビルド、reel.jsonによるメタデータ記述、プレーヤーの起動、フィードバックの適用、再レンダリングという一連のサイクルを管理します。主にClaude CodeなどのAIエージェントで動作し、動画制作におけるイテレーションを劇的に高速化します。プロジェクトは1フォルダに1動画で管理され、セルフレビュー、安全圏確認、コントラストチェックなどのベストプラクティスも組み込まれています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jishanpathan7/motionsnip-studio/tree/HEAD

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

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

ドキュメント

MotionSnip Studio

あなたは動画を構築します。ユーザーはローカルプレーヤーでそれを確認します。ループは以下の通りです:

  1. 動画を構築してレンダリングします。
  2. reel.json に動画を記述します。
  3. プレーヤーを開きます。
  4. ユーザーが確認し、Claudeに送信 をクリックします。あなたは次の1行を受け取ります: Apply the MotionSnip Studio feedback in <絶対パス>
  5. フィードバックを適用し、再レンダリングし、version をバンプします。プレーヤーは自動的にリロードし、ユーザーが変更を確認するのを助けます。

このファイルでは、<skill dir> はこの SKILL.md が置かれているフォルダ(通常は ~/.claude/skills/motionsnip-studio)を意味します。

1. プロジェクトのセットアップ

動画ごとに1つのフォルダを使用します:

<project>/
  reel.json        あなたが記述するファイル
  video.mp4        レンダリング結果(任意の名前;reel.jsonの"src"がこれを指す)
  assets/          音楽、画像、ロゴ(ユーザーがアップロードしたものもここに配置)
  public/          オプション;RemotionのstaticFile()アセット
  exports/         プレーヤーのエクスポート機能で作成;編集禁止
  .motionsnip/     プレーヤーの状態と履歴;編集禁止

ユーザーがまだレンダラーを持っていない場合、Remotionが良いデフォルトです(npx create-video@latest)。mp4、webm、movを出力できるツールなら何でも動作します。

2. 編集が容易になるように構築する

  • コピー、色、フォント、タイミングは1つのデータオブジェクト(Remotionの defaultProps や content.ts)にまとめ、コンポーネントに散らばらないようにします。そうすれば、フィードバック編集は1行の変更で済みます。
  • すべての画面上の要素に安定したIDを割り当て、reel.json でも同じIDを使用します。
  • 音楽は別ファイルとして提供します。動画自体は効果音のみでレンダリングします。 トラックは assets/ に置き、audio.music でそれを指定し、audio.videoAudio を "effects" に設定します。プレーヤーは動画の横で音楽を再生するため、ユーザーは再レンダリングなしでトラックの差し替え、開始位置の移動、音量レベルの設定ができます。エクスポート時にffmpegでミックスされます。
  • ユーザーが明示的に要求した場合のみ、動画に音楽を焼き込みます。その場合、videoAudio を "mix" に設定します。

3. 表示する前にレンダリングして確認する

レンダリングしたら、コンタクトシートで自分の作業を確認します:

ffmpeg -v error -y -i video.mp4 -vf "fps=1,scale=480:-1,tile=4x3" -frames:v 1 /tmp/sheet.png

画像を開いて確認します。クリップされたテキスト、空のフレーム、間違った色、タイミングのギャップを、プレーヤーを開く前に修正します。1フレームのみの場合:

ffmpeg -v error -y -ss 12.4 -i video.mp4 -frames:v 1 /tmp/frame.png

自己レビューを実施します。 その後、辛口のレビュアーのように再度確認し、まだ気になる点を書き留めます。以下の項目をチェック:

  • 安全圏。 各端から10%内側に収める必要がある重要なものは?(タイトルセーフ)
  • サイズ。 本文テキストはフレーム高の約3%以上あるか、携帯電話で読めるサイズか。
  • コントラスト。 テキストとキーシェイプが背景から明確に区別できるか。
  • タイポとオーバーフロー。 すべての単語のスペルが正しいか、クリップやボックスからはみ出しているものはないか。
  • カットとタイミング。 カット時にフラッシュフレームがないか、空のフレームがないか、読める前に消えてしまうものがないか。

修正できるものは修正します。残ったもの、または好みの問題については、reel.json の review にフィードバックを追加します(セクション4)。プレーヤーは各フィードバックをC1、C2…とラベル付けされた青色の破線の円でそのフレーム上に描画し、ユーザーはそれを自分のメモとして追加するか、却下できます。フレームキャプチャで実際に確認したものだけを記述します:時間、およびスポットまたは要素を指定して、円がそこに配置されるようにします。review は言うことがない場合は空のままにし、追加しないでください。

4. reel.json を記述する

reel.json はあなたとプレーヤーの間の契約です。プレーンなJSONで記述します(コメントなし)。

{
  "id": "acme-launch",              // 安定したID;ユーザーの保存済み編集はこれでキー付けされる
  "title": "Acme launch",
  "version": 1,                     // レンダリングのたびにバンプ;変更されるとプレーヤーがリロードする
  "path": "/abs/path/to/project",   // 作業場所;プロンプトに表示される
  "src": "video.mp4",
  "w": 1920, "h": 1080, "fps": 30, "duration": 32.0,
  "reference": "optional: what the video is modelled on",
  "brand": {
    "colors": [{ "id": "accent", "name": "アクセント", "v": "#5B5BF7" }],
    "fonts":  [{ "id": "head", "name": "見出し", "v": "Inter" }],
    "logo": "assets/logo.svg"       // またはnull
  },
  "audio": {
    "music": "assets/track.mp3",    // 動画の横で再生される音楽、またはnull
    "videoAudio": "effects",        // "effects" = 動画は効果音のみ;"mix" = 音楽が焼き込まれている
    "bpm": 120, "drop": 4.0,        // オプションのビートグリッド;drop = ドロップが来る秒数
    "musicVol": 1, "sfxVol": 1,     // 0..1
    "musicOffset": 0,               // 秒;+ は音楽の開始を遅らせる、- はトラック内をスキップする
    "musicFade": 0,                 // 秒;最後のフェードアウト時間
    "note": "自由テキスト"
  },
  "assets": [{ "id": "assets/track.mp3", "name": "track.mp3", "type": "audio", "from": "User" }],
  "scenes": [
    { "id": "S1", "name": "フック", "t": [0, 4.5], "els": [
      { "id": "headline", "label": "見出し", "t": [0.3, 4.3],
        "box": [20, 38, 60, 24],    // x, y, w, h をフレームの%で指定;ナレーション、オーディオ、全画面フッテージの場合はnull
        "src": "src/Hook.tsx:12",   // それを描画するファイル(または file:line)
        "props": {
          "text":   { "type": "text",   "label": "テキスト",   "v": "Acmeを紹介" },
          "color":  { "type": "color",  "label": "色",  "v": "brand.accent" },
          "motion": { "type": "motion", "label": "モーション", "v": "単語が1つずつぼかしインする" }
        } }
    ] }
  ],
  "notes": [],
  "review": [                       // オプション:自己レビューの結果(セクション3)
    { "id": "v1-1", "t": 1.5, "elId": "headline", "kind": "安全圏",
      "title": "見出しが右端にかかる",
      "detail": "1.5秒で最後の単語が端から2%の位置にあり、タイトルセーフ範囲外です。",
      "fix": "ボックスを56%に狭めるか、サイズを1段階下げてください。" }
  ],
  "outputs": [                      // オプション:そこから作成した他の形状や長さ(セクション9)
    { "id": "vertical", "label": "9:16", "kind": "reframe", "src": "out/vertical.mp4", "w": 1080, "h": 1920, "platform": "reels" }
  ],
  "live": "live.js",                // オプションのライブレンダラー(セクション7)
  "export": { "cwd": "/abs/build/folder", "props": {}, "cmd": "npx remotion render ... \"$OUT\" --props=\"$PROPS\"" }  // オプション(セクション8)
}

ルール:

  • プロップの種類: text, longtext, number, color(brand.<id> でパレットにリンク)、media(アセットID)、list(行;cols: [{ k, type, options? }])、choice(options: [...])、motion(動きのプレーンな説明;ユーザーはコメントのみ可能)。
  • シーンは 0..duration を隙間なくカバーします。時間は秒です。
  • シーンと要素のIDはバージョン間で安定させてください。保存された編集はIDで照合されます。
  • box は要素が実際に画面上にある位置と一致する必要があり、フレームの%で指定します。不明な場合はフレームキャプチャから測定してください。ユーザーはこれらのボックスをクリックして要素を選択します。
  • src は要素を描画するコードを指すようにし、後で見つけられるようにします。
  • すべてのプロップ値は実際にレンダリングされるものと等しくなければなりません。新しい reel.json の値が要求されたものと一致すると、プレーヤーは編集を完了としてチェックします。
  • path は省略可能;サーバーがプロジェクトフォルダを補完します。
  • review のフィードバック: id(このバージョン内で一意、例: v2-1)、t(秒)、title(1行)、オプションで detail、fix、kind(safe area、size、contrast、typo、overflow、cut、timing、または独自の単語)。elId(要素ID、そのボックスにリングが付く)、box: [x, y, w, h]、またはフレームの%での x、y で配置します。バージョンごとに新しいリストを記述し、ユーザーが却下したものを繰り返さないでください。
  • outputs: セクション9を参照。
  • 不明なフィールドは無視されます。欠落したオプショナルフィールドにはデフォルト値が使用されます。

5. プレーヤーを開く

サーバーをバックグラウンドで起動し、ユーザーに出力されるURLを伝えます:

node <skill dir>/player/server.mjs <project> &
# MotionSnip Studio: http://localhost:4321  (project: /abs/path)

オプション: --port 4321(ビジーの場合はポートがずれる)、--no-open(ブラウザを開かない)、--ffmpeg /path/to/ffmpeg(エクスポート用)。Node 18以上、インストール手順は不要。このプロジェクトのサーバーがすでに実行中の場合は、新たに起動しないでください。プレーヤーは新しいバージョンを自動的に検出します。

ユーザーに1〜2行で何をすべきか伝えます:視聴し、修正したいものをクリックし、問題を右クリックで丸で囲み、Claudeに送信 をクリックします。

プレーンな動画の場合。 ユーザーが reel.json のない動画ファイル(画面録画、電話のクリップなど)をレビューまたは編集したい場合は、ファイル自体を渡します:node <skill dir>/player/server.mjs path/to/clip.mp4 &。reel.json は作成しないでください。プレーヤーはトリミング、カット、テキスト、ロゴ、ぼかしの追加、色の設定を可能にし、エクスポート時にそれらの編集を自身で適用します。フィードバックファイルにはフレームにピン留めされたメモのみが含まれます。それに従い、メモが新しいカットを要求した場合は、同じファイル名でエクスポートし、プレーヤーが次のバージョンとして認識するようにします。

6. フィードバックファイルを適用する

ユーザーが Apply the MotionSnip Studio feedback in <project>/.motionsnip/feedback-vN.md を貼り付けます。そのファイルを読みます。以下の部分があります:

  • 正確な変更。 [00:01.2 · S1 · 見出し] テキスト (src/Hook.tsx:12): "Acmeを紹介" -> "Acmeに挨拶" のような行。その変更をコードと reel.json に正確に適用します。言い換えないでください。brand.<id> への色の編集はパレットエントリを変更するため、それにリンクされているすべてのものが変更されます。
  • サイズと位置の編集。 [x, y, w, h] -> [x, y, w, h] (scale 1.12) をフレームの%で指定。フレームサイズでピクセルに変換し(x% * w / 100)、コード内の要素を移動/リサイズし、box を更新します。
  • サウンド設定。 新しいトラック(すでに assets/ に保存済み)、開始オフセット、フェード、音量。reel.json の audio を更新します。動画が効果音のみを保持している場合、通常これらのために再レンダリングする必要はありません。音楽が焼き込まれている場合(videoAudio: "mix")、新しい設定で再レンダリングします。
  • {ラベル} バージョンへのコメント。 マスターではなく、カットダウン(9:16、1:1、バンパー)に残された同じ種類のコメント。時間とスポットはそのバージョンのフレームとクロックに基づきます。バンパーのセクションには、マスターのどの部分がカットされたかが示されます。可能な場合はマスターの原因を修正します(重要なものをクロップで見えるように保つ)。そのバージョンを自分で作成した場合(outputs にある場合)、それも再レンダリングし、独自の version をバンプします。
  • MotionSnip Studioで作成されたカットダウン。 プレーヤーがマスターから自身でレンダリングするバージョンで、クロップキーまたは範囲が指定されます。それらのファイルはそのままにしておきます。レビュアーは次のバージョンの後にそれらを再レンダリングします。
  • フレーム上のコメント。 時間とスポット(x 23.9% y 81.8%)にピン留めされた自由コメントで、多くの場合名前付き要素上にあります。そのフレームをキャプチャし、何をすべきか判断する前に確認します。メモは要求であり、正確な値ではありません。判断力を使用し、シーンの残りの部分はそのままにします。
  • vN-1からまだ完了していないもの。 前回のラウンドで変更したが、ユーザーがまだ正しくないと言っているものとその理由。これらを最初に修正します。
  • 自己レビューから。 (自己レビュー v1-2 から;レビュアー同意) で終わるコメントは、ユーザーが受け入れた自分のフィードバックです。他のメモと同様に扱います。
  • 自己レビューから却下されたもの。 ユーザーが確認し、満足しているフィードバック。それらはそのままにし、次の review で再度フラグを立てないでください。
  • シーン。 各シーンのステータス。承認済みのシーンには、編集やメモで名前が指定されていない限り触れないでください。

その後:

  1. 変更を加えます。IDは安定させてください。
  2. 同じ src ファイル(または新しいファイルにレンダリングして src を更新)に再レンダリングします。
  3. コンタクトシートと、触れたフレームを確認します。
  4. reel.json の変更されたすべての値を更新し、version を N+1 に設定します(ファイルに番号が示されています)。バージョンはレンダリングが完了した後に最後にバンプします。
  5. 変更内容を1行でユーザーに伝えます。例:「v4 を適用 · 5つの変更を適用、アウトロのメモはあなたの確認が必要です」。

.motionsnip/、exports/、または outputs/ 内のプレーヤーのカットダウン(.motionsnip/outputs.json にリストされている)は決して編集しないでください。それらはプレーヤーに属します。

7. オプション:ライブレンダラー

動画がブラウザで実行できる場合(canvas、DOM、Remotion Playerバンドル)、live.js を提供し、"live": "live.js" を設定できます。プレーヤーはそれをクラシックスクリプトとして読み込み、以下の関数を呼び出します:

window.MotionSnipLive = (container) => ({
  seek(timeSeconds) {}, play() {}, pause() {}, setRate(rate) {},
  // boxes[id] = [x, y, w, h, nx, ny, nw, nh]: 元の値、次に編集後の値、フレームの%
  setBoxes(boxes) {},
});

プレーヤーは動画を非表示にし、あなたのレンダラーを駆動するため、移動またはリサイズされた要素が実際に表示されます。

8. オプション:エクスポートフック

reel.json に export を追加すると、ユーザーがプレーヤーから最終出力をレンダリングできるようになります:

"export": {
  "cwd": "/abs/path/to/remotion/project",
  "props": { "musicSrc": null },
  "cmd": "npx remotion render src/index.ts Main \"$RAW\" --props=\"$PROPS\""
}

サーバーは cwd で cmd を sh -c で実行し、以下の環境変数を設定します:

  • PROPS: export.props とユーザーの編集内容をマージした JSON ファイルへのパス。編集内容は { "edits": { "<elId>": { "<prop>": value } }, "boxes": { "<elId>": [x, y, w, h] }, "colors": { "<id>": "#hex" }, "fonts": { "<id>": "Name" } } として渡されます(ボックスはフレームの%)。コンポジションがこれらを読み取るようにして、レンダリングに反映させます。
  • OUT: exports/ 内の最終ファイル。レンダリングにすべてが含まれている場合はここに書き込みます。
  • RAW: 一時パス。代わりにここに書き込み、サーバーがユーザーの選択した音楽とレベルをミックスして OUT を作成します。
  • PROJECT: プロジェクトフォルダ。

進捗はコマンドが出力する最後の n/m ペアから取得されます(Remotionはこのようにフレームカウントを出力します)。

エクスポートフックがなくても、エクスポート機能は動作します。動画をコピーし、ffmpegで音楽をミックスします。

9. オプション:他の形状と長さ(出力)

プレーヤーは自身でカットダウンを作成します:+ カットダウン は、マスターからffmpegを使用して9:16、1:1(または縦マスターから16:9)、または6秒のバンパーを outputs/<id>.mp4 にレンダリングします。リフレームは、レビュアーがマスター上でドラッグしたクロップキー(または要素ボックスからの最初の推測。そのため box を正確に保つこと)に従うか、ぼかしフィル上にフレーム全体を収めます。各出力は独自のタブ、Reels、TikTok、Shorts用の安全圏ガイド、および独自のメモを取得します。これらのために何かする必要はありません。

コードで構築された動画が他の比率やバンパーに適したレイアウトになる場合は、それらを outputs にリストし、reel.json の review、notes、audio 設定を適用できるようにします。

10. 動画の種類を理解する

異なる種類の動画は異なる期待を持ちます:

動画の種類典型的な長さスタイルとペース注意事項
起動動画15–60秒強烈なフック、速いカット、ビッグタイポグラフィ序盤のミリ秒が重要。ロゴは最後に表示されることが多い。
説明動画60–120秒明確なナレーション、イラスト、控えめなモーションテキストを明確で読みやすく保つ。複雑な概念をシンプルな視覚要素に分解する。
製品動画15–45秒製品ショット、機能ハイライト、テンポの良い音楽製品を早く表示する。機能のオーバーレイテキストを使用する。
バンパー6秒超速いカット、1つのアイデア、強いブランディング短い。最初の0.5秒以内に注目を集める。
ソーシャルクリップ15–60秒縦、キャプション、サムネイルで始まる上部と下部にテキストのためのスペースを確保する。最初の3秒でフックする。

これらの期待を映像制作プロセスに反映させます。reel.json の reference に動画の種類を記述すると、レビューがよりターゲットになります。

11. 一般的な注意事項

  • 音楽は最後まで管理します。 音楽の切り替えは、動画が "mix" でレンダリングされていない限り、頻繁に発生します。音楽を "effects" にしておくことで、再レンダリングなしでこれらを処理できます。
  • 動画が変更されると、プレーヤーがリロードします。 version を変更すると、プレーヤーは新しいレンダリングを自動的に取得します。変更をプッシュするだけで、ブラウザがリロードされます。
  • モーションとタイミングはメモに任せます。 あなたは動きを正確に設定し、ユーザーはそれにコメントできます。motion プロップに複雑さを入れすぎないでください。ユーザーが求めるものは調整であることを理解してください。
  • 拡大して確認します。 携帯電話の画面は小さいです。テキストサイズとコントラストは特にプレビューが難しいです。動画を縮小して確認し、視認性をテストします。
  • 実験的で協力的です。 複数のバージョンを迅速に生成します。これは対話的なプロセスであり、ユーザーはあなたと協力しています。

12. フェイルセーフ

  • プレーヤーが応答しない場合: サーバーを再起動します(kill $(lsof -ti:4321)、その後 node ... &)。
  • レンダリングが停止した場合: reel.json の妥当性を確認します(欠落した src、不正な duration)。
  • フィードバックファイルがありません: ユーザーに Apply the MotionSnip Studio feedback in <project>/.motionsnip/feedback-vN.md を貼り付けるよう依頼します。
  • バージョンの競合: プレーヤーは最新の version を使用します。シンプルに保ちます。
  • アセットが見つかりません: assets/ 内のパスを確認し、絶対パスまたは相対パスが必要かどうかを確認します。

関連スキル