Communitygithub.com

yazzang-homelab/motion-studio

Claudeに自身のフレームを批評させます:critique.mjsの証拠、厳格な7軸スコア、タイムスタンプ付きP0/P1/P2問題をdocs/review_log.mdに記録し、最悪の3つを修正、再確認、ゲート通過。「critique it」、「review the frames」、「is it good」に使用します。

motion-studio とは?

このスキルは、Claude Opusが自身でレンダリングした映像フレームを批評・改善するための反復的な批評ループを提供します。studi.jsonを含む映像プロジェクトルートで動作し、critique.mjsツールを使用してPNGフレーム群の証拠を生成し、7つの評価軸(決定性、フォント、デッドスパン、ポップ、フレーム0、コーナー/ボーダー、同期、オーディオ、無音)に基づいてスコアリングし、P0/P1/P2の重大度で問題をタイムスタンプ付きでdocs/review_log.mdに記録します。最悪の3つの問題を修正した後、再確認し、全軸が8以上かつP0がなくなるまで(指定されたゲート許可軸を除く)、あるいは最低3ラウンドを達成するまでループを続けます。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで使用することを想定しており、映像制作における品質管理と反復的な自己改善を自動化します。

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

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

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

ドキュメント

批評ループ(コースステップ11)

Opusは画像を読み取れるため、自身がレンダリングしたものを確認できます。この習慣が、「まあまあ」で終わる作品と、実際に成功する作品を分けます。反復は失敗ではなく方法です:広く共有された45秒のショート作品は、約6.75時間に163回のモデル呼び出しを要しました。このスキルはhigh努力レベルで実行されます。なぜなら、フレームを正直に判断するには意図的な注意力が必要だからです。

critique.mjs 証拠 -> すべてのPNGを確認 -> 7軸でスコア付け -> P0/P1/P2をタイムスタンプ付きで -> ラウンドを
docs/review_log.mdに追記 -> 最悪の3つを修正 -> 影響を受ける秒数を再確認 -> 次のラウンド
まで:
>= 3ラウンド かつ 最終ラウンドの全軸 >= 8 (gate.naAllowedで指定されたものはnaのみ) かつ P0なし -> npm run gate -> npm run render:final

映像プロジェクトルート(studio.jsonがあるフォルダ)で作業します。引数(フォーマットと変更内容、両方ともオプション。フォーマットのデフォルトはstudio.jsonのprimaryFormat)は、一度だけ表示されます:

このスキルのファイルは${CLAUDE_SKILL_DIR}にあります。以下の相対リンクはそこを指しています。

レビューのみ、再レンダリングなし:ユーザーが既存の証拠(コンタクトシート、静止画、動画)を確認するよう要求し、コードに触れない場合、ステップ1、5、6をスキップします。既存のファイルを確認し、スコアリングし、ラウンドを追記します(ステップ4)。

0. ラウンド1の前に

  • docs/shotlist.mdが承認され、npm run lintがクリーンで、npm run previewで映像が再生されること。
  • サウンド軸を評価するにはオーディオが必要です:最初にnpm run score(または提供されたトラックの場合はnpm run beats -- <track>)とnpm run sfxを実行し、キュー、ビートグリッド、同期メトリックが存在するようにします。
  • サウンド軸はミックスされたレンダリングからスコアリングされ、批評家はレンダリングやミックスができません。キュー、音楽、または映像タイミングが変更されたすべてのラウンド(常にラウンド1と最終ラウンド)の前に、それをビルドします:node tools/render.mjs --format <fmt> --draft --sub 1 --scale 0.5、npm run sfx、node tools/mix.mjs --format <fmt>。次に、スコアリングまたは批評家への指示の前に、ステップ1の両方の証拠パスを生成します。

1. 証拠の生成

互いに上書きしない2つのパス。このクラスのPCで測定:ライブパスは12秒のデモで約115秒、20秒の映像で約145秒(3つの決定性パスと15〜25秒のブラウザ起動時間が支配的)、--videoパスは20秒の映像で約85秒、1回のmotion-critic実行で5〜12分。各パスはバックグラウンドで開始し、そのログをポーリングします。フォアグラウンドで約2分以上待機しないでください:

node tools/critique.mjs --format 9x16                              # ライブ映像 -> out/review/9x16/
node tools/critique.mjs --format 9x16 --video out/9x16/final.mp4   # ミックスレンダリング -> out/review/9x16/video/

ライブパスは、決定性、正確なピクセル、loop.png、キュー同期を保持します。そのオーディオ行はn/aと表示されます。ビデオパスは、ラウドネス、トゥルーピーク、オーディオ長、エンコードに実際に含まれるものを保持します。決定性パスをスキップし、loop.pngを書き込みません。サウンドはビデオパスから、その他は両方からスコアリングします。ミックスがない場合、サウンドには証拠がありません:欠落した証拠を示すP1(そのようなラウンドは最終ラウンドにはなれません)で4以下のスコアを付けます。

out/review/<fmt>/内のファイル(video/内も同名)内容確認ポイント
metrics.md / metrics.json決定性の不一致、描画テキストのグリフカバレッジ(フォント、ライブパス)、デッドスパン、ポップ、フレーム0、ループシーム、コーナー、ボーダー、キュー同期、オーディオおよび無音スパン(--videoパス)、すべてのシートの全ページリスト最初に読む。すべてのフラグは問題か文書化された却下のいずれかになる
contact.pngビートごとに1つの静止画、time · beat · shotとラベル付け。すべてのシート(contact、shots、phone、strip。npm run stillsとcritique.mjsの両方)は、ページ全体の行に分割されます:ページの高さは--page-height(デフォルト1800px)以下、幅は1990px以下。ページ1はcontact.png、次にcontact-2.png、contact-3.png...。metrics.mdはすべてのページをリストするので、すべてを開いてください。--from S --to Sで1チャプターをレビューデッドビート、ショットの繰り返し、状態変更時のオーバーラップ
phone.png1秒あたり1つの静止画、幅360pxスマートフォンでの可読性
shots.pngショットの中間点ごとに1つの静止画構図、禁止ルック、階層
strip.png最も速いアクションの周囲の12連続フレーム(--strip-at Sで選択)スライド、ポップ、再起動、テキストオーバーラップ
loop.pngループ映像のみ(studio.json loop: true、キャンバスフィルム、ライブモード):ペインは以下で説明シームジャンプ、閉じないループ

node tools/critique.mjsのすべてのフラグ(--helpで同じリストを表示):

フラグ効果
-f, --format <fmt>レビューするフォーマット。デフォルトはprimaryFormat。ファイルはout/review/<fmt>/に保存される
--video [path]ライブ映像の代わりにレンダリングされたmp4をレビュー。--videoのみの場合はout/<fmt>/final.mp4、それ以外はsilent.mp4。統合LUFS、トゥルーピーク、オーディオ長を追加。決定性パスをスキップ。loop.pngを書き込まない(連続性メトリックのみ)。すべてはout/review/<fmt>/video/に保存されるため、ライブ証拠はそのまま残る。レポートは両方のフォルダを名前で示す
--from <sec>, --to <sec>長い映像の1チャプターをレビュー:静止画、すべてのシートとすべてのメトリック(デッドスパン、ポップ、決定性サンプル、グリフカバレッジ、無音スパン、キュー)はその範囲のみをカバーし、metrics.jsonはrangeに記録する。フレーム0とループシームは映像全体に対してのみチェックされる(スキップされたと報告)、ラウドネスは常にファイル全体、自動ストリップは範囲内に留まる。不正な範囲(--fromが終了を超える、--toが--from以上でない、3フレーム未満)は使用エラーで終了コード2
--page-height <px>1枚のシート画像の最大高さ(デフォルト1800px。画像ビューアは約2000pxを超えるものを縮小する)。より高いシートは、タイル行全体のページに分割される(contact.png、contact-2.png...。0 = 1枚の高いシート)。ページ幅も1990pxを超えることはない(--colsが収まるように下げられる)
--strip-at <sec>12フレームのストリップをある瞬間(例えば問題のある時間)に中央揃えする(デフォルト:最も動きのある瞬間)
--no-determinismこのラウンドで決定性パスが合格し、画像のみが変更された場合、3つのハッシュパスをスキップする
--skip-determinism-repeat映像ハッシュ、assets/(画像、フォント、オーディオ、キューデータ:名前、サイズ、コンテンツ)配下のすべてのファイル、フォーマット、--from/--to、およびパスのコードが変更されていない場合、前回のライブランの合格した決定性結果(フォルダ内のdeterminism-cache.json)を再利用する。film/**、lib/**、studio.json、assets/の編集はキーを変更するため、パスは再度実行される。不合格の結果は決して再利用されない。メトリック行はn/a ... reused from the run of <time>と読み取られる。Chromeのアップグレードはキーの一部ではない:アップグレード後は、フラグなしで1回実行する
--check-hashブラウザを起動しない:ライブ映像(sha256 of film/** + lib/** + studio.json)とout/review/<fmt>/内の証拠を比較する(video/の場合は--videoを追加)。終了コード0 = 同じ映像、1 = 変更またはハッシュなしで、変更されたファイルをリストする
--jsonレポートの代わりに1行のJSON結果(パス、すべてのシートのpages、range、サマリー、findings、nextRound、ゲートステータス)を出力する
-h, --help使用法

--jsonなしの場合、レポートが出力される:証拠リスト、メトリックテーブル、機械発見の候補問題、ルーブリック、次のラウンド番号が入った記入準備済みのレビューログブロック(metrics.mdとしても保存される)。ツールは決してスコアリングしない。--jsonの場合、行はdir(この実行が書き込んだ場所)とother(他方のモードのフォルダ、モード、時刻、またはnull)を運ぶ。

loop.pngペイン、左から右へ(すべて同じ方法でダウンスケール):

ペイン表示内容読み方
最終フレームフレームN-1シーム直前の状態
t=dur アンラップt = durationでの生の終了状態ランタイムがhash(t, { wrap: false })を尊重する場合のみ存在し、ツールが最初にテストする
seek(0)フレーム0シーム後の状態
|last - first| x4最終フレームとフレーム0の差、4倍増幅2つの連続フレーム間の通常の1ステップのように見えるべき
|end - first| x4アンラップされた終了状態とフレーム0の差、4倍増幅黒であるべき:t = durationはフレーム0。アンラップペインがある場合のみ存在

metrics.jsonのループ判定loop = { enabled, unwrapped, invariant, hashEqual, endDiff, seamDiff, prevDiff, ratio, continuity, closes, pass }。continuity = 最後から最初へのステップが、最後の2フレーム間のステップの最大1.5倍(またはcritique.staticEps未満)。closes = hash(0)がhash(duration, { wrap: false })と等しいか、それらの平均差が0.1未満。失敗は映像の終わりのP0。アンラップペインがない場合(古いランタイム、DOMフィルム)、連続性のみが測定され、レポートはそのように述べる。

すべての証拠フォルダはまた、film-hash.json(証拠が示すフィルムバージョン。filmHashはmetrics.jsonで繰り返される)とbaseline.json(最後の実行のポップ、ジャンプ、デッドスパン候補時間)を保持する。レビューに関する2つの結果:

  • フィルムバージョン:ライブフィルムからズーム静止画をレンダリングする前に、node tools/critique.mjs --check-hash --format <fmt>を実行する。不一致は、静止画がコンタクトシートよりも新しいフィルムを示すことを意味する:停止し、不一致を報告し(コマンドは変更されたファイルを名付ける)、新しい証拠を要求する。批評家がレビューしている間はフィルムを編集しない。
  • デルタ:フォルダ内の2回目の実行から、metrics.mdはsame as previous run: N of M candidatesを出力し、新しいものを最初にリストする(機械発見リストは各重大度内で新しい発見を最初に配置し、他のものに[same as the previous run]とマークする)。新しいものを完全にレビューし、フィルムがその時間近くで変更された場合にのみ古いものを再検証する。

ステップ(ピクセルアート、「オンツー」)フィルムは意図的にハードステップを作る。studio.jsonで設定:critique.stepped: trueはすべてのjumpをP2の発見の代わりに情報としてリストする(metrics.jsonのpops.info、metrics.mdの「Suppressed by studio.json」セクション)。1フレームのflickerはP1のまま。critique.popIgnore: [[t0, t1], ...](秒、0 <= t0 < t1)は、意図されたスパン内の両方の種類を黙らせる(pops.ignoredはそれらをスパンとともにリストする)。metrics.mdは、各設定がいくつの候補を保留したか、その理由を述べる。これはフィルムの文法であり、閾値調整ではない:本当のグリッチは、ステップスパン外のフリッカーまたはジャンプとして依然として表示される。

メトリックセマンティクス。フラグが正しくトリアージされるためのもの:

メトリック失敗条件発見
決定性サンプリングされた任意の時間のハッシュが、順序通り、シャッフル、または新しいページで異なる(サンプルはすべてのショット境界とキューにまたがる)P0
フォント(ライブパス)フィルムが描画する文字に、そのフォントにグリフがない、またはファミリーが登録されていない、またはジェネリック(sans-serif)の場合:マシンはシステムフォント(コンピュータごとに異なる)またはトーフボックスを描画する。ページはwindow.__TEXT_TRACK__ = trueで開かれるため、text()、kinetic()、textWidth()は描画するものを記録し、__studio.coverage()がそれを判定する。フォント行ごとに1つの発見が、ファミリーとウェイト、最大40の欠落文字、合計数、修正を名付ける。textUse()のないページはpreflight: unavailableという注意を与え、発見にはならない。パスが描画しなかったフレーム上のテキストは見られないP0 font-fallback
デッドスパンcritique.deadSpanSec(2秒)以上の間、平均フレーム差がcritique.staticEps(0.35)未満P1
ポップ、flicker1フレームが両方の隣接フレームと、それらが互いに異なる量のcritique.popRatio(3)倍以上異なるP1(キューの隣の意図されたフラッシュは文書で却下される)
ポップ、jump差のスパイクが、4つの隣接する差の平均のpopRatio倍以上:何かがテレポートした、ポップインした、または反転したツールからのP2。ショットを損なう場合はP1に引き上げる。critique.stepped: trueの場合は情報のみ。critique.popIgnoreスパン内のものはなし
フレーム0ほぼ空:ピクセルの0.5%未満がスムーズな背景(プレーンフィル、グラデーション、ビネットはすべて背景としてカウント)と異なるP0
コーナー、ボーダーサンプリングされたフレームの30%以上で、コーナーボックス内に小さなコンテンツ(critique.cornerPct、8%)。3辺以上に突然の内部ステップを持つ細く均一なエッジラインが25%以上(ビネット、グラデーション、または色付き背景上のカードはボーダーではない)ツールからP1、目視で確認された場合はP0(禁止ルック)
同期ヒットしたキューの80%未満(4つ以上のキュー)がビートの25ミリ秒以内にある、またはショットチェンジがダウンビートから外れている。ライザー、ウーッシュ、スウーシュは意図的にビートをリードしカウントされないP2
オーディオ(--video)オーディオストリームなし、ラウドネスがターゲット外、トゥルーピークがターゲット超過、オーディオ長がビデオから1フレーム以上ずれているオーディオストリームなしまたはトゥルーピークが0 dBTPを超える場合はP0、それ以外はP1
無音(--video)-50 dB未満の1秒以上の無音スパン(ギャップごとに1つの発見、silence 3.2 s at 00:08.1)。最初の0.3秒以内に始まるもの、最後の1.0秒以内に始まるもの、またはcritique.allowSilence間隔内にあるものは除く。早期に終了するステムはミックス後も-14 LUFSを測定するため、ラウドネスはそれを検出できないP1 audio-gap(オーディオ行はWARNと読み取られる)

両方のポップ種類はまた、0〜255スケールで平均ステップが1.0を超える必要があるため、ほぼ静的シーンではトリップしない。ショット境界でのハードカットはポップとしてではなくカットとしてリストされる。キャンバスフィルムは半分以上のサイズ(pixelScale)でスキャンされる。なぜならChromeのCPUキャンバスは小さなサイズでグリフをピクセル全体にスナップし、偽のジャンプを引き起こすから。DOMフィルムはスクリーンショットから10 fpsでサンプリングされる。フラグを消すためにcritiqueの閾値を決して変更しない。

2. 適切に確認する

Readツールで全ての画像を開く。metrics.mdだけでスコアリングせず、コードの記憶からもスコアリングしない。順序:metrics.md、contact.png、phone.png、shots.png、strip.png、loop.png(それぞれが持つ全てのページ:contact-2.png、contact-3.png...。metrics.mdの証拠リストがそれらを名付けるか、フォルダをリストする)、次にvideo/metrics.mdのオーディオ行。docs/shotlist.md(承認されたもの)と比較する。

Individual skills in this repo

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

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

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

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'.

関連スキル