Communitygithub.com

yazzang-homelab/motion-studio

1つのタイムラインからすべてのフォーマットを出力し、パッケージ化する:layout()によるリフレーミング(トリミング禁止)、全フォーマットレンダリング、フォーマット別チェック、deliver.mjs、ブランドスキル、サービス提供。'9:16と16:9を書き出し'、'納品'、'スキル作成'で使用。

motion-studio とは?

Motion Studioは、映像制作者が1つのタイムラインから複数のソーシャルメディアフォーマット(9:16、1:1、16:9、4:5)を同時に生成し、品質チェックから納品までを自動化するAIエージェントスキルです。トリミングではなくスマートなリフレーミングを採用し、各フォーマットで同じ瞬間が同じタイミングで表示されることを保証します。レンダリング、ミックス、納品パイプラインはバックグラウンド実行に対応し、配信ファイルのサイズ制限、ラウドネス、無音区間などを自動チェックします。さらに、このパイプラインをユーザー自身のブランドスキルとしてパッケージ化する機能を備えており、「次の動画が一文で作れる」状態を実現します。Claude Code環境で動作し、`/motion-studio:motion-reel`や`/<ブランド>-reel`というインターフェースで利用できます。

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

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

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

ドキュメント

フォーマット出力、スキル、サービス提供(コースステップ12)

3つのアクションで、良いクリップを再現可能なビジネスに変える:1つのタイムラインからすべてのフォーマットを書き出し、パイプラインをスキルとしてパッケージ化(次の動画は一文で作れるように)、そして必要に応じて販売する。フィルムプロジェクトのルートで作業する。引数は1回だけ表示:

このスキルのファイルは ${CLAUDE_SKILL_DIR} にあり(テンプレートは assets/ 内)。

1. フォーマットごとにリフレーム、トリミング禁止

シーンはレイアウト L(ファクトリ内では ctx.L、draw内では c.L)に従って描画されるため、1つのタイムラインで9:16、1:1、16:9(および4:5)を、各形状に合わせたタイプとUIでレンダリングできる。

フォーマットサイズラベル
9x161080x1920Reels、TikTok、Shorts
1x11080x1080X / フィード
16x91920x1080YouTube、サイト
4x51080x1350フィードポートレート
ツール用途
L.uサイズ単位:1080pxの短辺で1。120 * L.u はすべてのフォーマットで同じサイズに見える
L.Sstudio.jsonのsafe[fmt]によるセーフレクト {x, y, w, h}(プラットフォームUIマージン)
L.pos(ax, ay)セーフレクト内の点、ax, ay は0から1
L.pick({ '9x16': a, '1x1': b, '16x9': c, portrait, landscape, square, default })フォーマット別の値:正確なキー、次に縦横、最後にデフォルト
L.split('auto', ratio, gap)2つの領域:ポートレートとスクエアでは縦積み、ランドスケープでは横並び
L.cols(n, gap) / L.rows(n, gap)セーフレクト内の列または行
fitFontSize(g, text, maxW, (s) => font(s, family, weight), lo, hi, { tracking, step })幅に収まる最大サイズ(lib/layout.js + lib/draw.js)。step: 16 はビットマップフォント用
wrapText(g, text, maxW, font(size, family), { maxLines, ellipsis })複数行コピー用の行分割。ハングル音節の途中で切らない(lib/draw.js)
draw(g, lt, c) {
  const { L, brand } = c;
  const { a, b } = L.split('auto', L.pick({ landscape: 0.45, default: 0.4 }), 32 * L.u);   // タイトル | プロダクト
  const size = Math.min(L.pick({ '9x16': 170, '1x1': 140, '16x9': 150 }) * L.u,
                        fitFontSize(g, 'MAKE IT MOVE.', a.w, (s) => font(s, brand.fonts.display, 400)));
  kinetic(g, 'MAKE IT MOVE.', a.x, a.y + a.h * 0.6, lt, { size, family: brand.fonts.display, weight: 400, color: brand.colors.fg, spring: 'default' });
  drawProduct(g, b, lt, c);                                         // プロダクトUIはすべてのフォーマットで領域bを埋める
}

ルール:リテラルピクセルは使わない。主要コンテンツは L.S の内側に。同じ瞬間はすべてのフォーマットで同じ時間に発生する(配置とサイズのみ変更)。あるフォーマットが別のフォーマットのクロップのように見える場合は、批評でP1とする。safe マージンは studio.json で調整し、コードでは調整しない。各フォーマットは npm run preview でプレビュー(Fキーでフォーマット切り替え、Gキーでセーフガイド表示)。

2. すべてのフォーマットをレビュー

批評ループはプライマリフォーマットで実行。最終版の前に、少なくとも1ラウンドを他の各フォーマットでも実行し、それぞれ独自のエビデンスを添付する(ライブパスで約115秒、--video パスで約85秒のツール時間、12〜20秒のフィルムで計測):

node tools/stills.mjs --format 1x1
node tools/render.mjs --format 16x9 --draft --sub 1 --scale 0.5     # 約20秒。その後:npm run sfx、node tools/mix.mjs --format 16x9
node tools/critique.mjs --format 16x9                                 # ライブフィルム -> out/review/16x9/
node tools/critique.mjs --format 16x9 --video out/16x9/final.mp4      # ミックス済みレンダリング -> out/review/16x9/video/

各ラウンドは独立したラウンドとして記録する(## Round <n> — 16x9 — ...)。ゲートは最後のラウンドを読み取るため、合格するラウンドで終了すること。

3. レンダリング、ミックス、納品

これらには数分かかる:12秒のデモは、3つのフォーマットを60fpsでレンダリングするのに約4分(フィルム1秒あたり約20秒)、mix は40〜80秒、deliver は約40秒。npm run build、render:final、mix、deliver は、Bashツールの run_in_background オプションとログを使用して開始し、ログをポーリングし(tail -n 3)、exit 行の後に結果を読み取り、フォアグラウンドで約2分以上待機しないこと。3フォーマット以上または約30秒以上の最終レンダリングには --chunk 10 を追加する。モーションリールのランブック(「長いコマンド」)にパターンがある。

ステップコマンド出力
すべてを順番にnpm run buildスコア(ない場合)、sfx、全フォーマットの最終レンダリング、ミックス、納品
最終レンダリング(ゲート付き)npm run render:finalout/<fmt>/silent.mp4、poster.png、studio.json の formats にある全フォーマットの render.json
ミックスとマルチプレックスnpm run mixout/score.wav、out/<fmt>/final.mp4、out/final.mp4(プライマリ)、out/poster.png
チェックとパッケージングnpm run deliverout/deliver/<slug>_<fmt>.mp4 + ポスター + コンタクトシートの全ページ(<slug>_<fmt>_contact.png、続いて _contact-2.png...)、out/deliver/manifest.json、docs/production.json

deliver.mjs はフォーマットごとに、現在の studio.json に対して out/<fmt>/final.mp4 をチェックする:フレーム数(duration x fps)、フォーマットのサイズ、fps、正確なduration(duration または fps の編集前にレンダリングされたカットは stale render として不合格。ドラフトやスケーリングされたレンダリングも不合格)、audio.lufs +- audio.lufsTolerance および audio.truePeak に対する統合ラウドネスとトゥルーピーク。無音区間(1秒以上-50dB未満の区間は silence として不合格。例:silence 2.2 s at 00:02.1。ただし、先頭0.3秒以内で始まる場合、最後の1秒で始まる場合、または critique.allowSilence インターバル内にある場合を除く)。ファイルサイズは deliver.maxBytes に対して(デフォルト x:536,870,912 バイト = Xの512MBアップロード制限。他のプラットフォームの制限はそこに追加)。ポスターの有無。ループフィルムのループシーム。批評ゲート。フィルムソースがレンダリングより新しい場合は警告(不合格にはならない)。exitコード1で失敗したチェックをすべて列挙。final.mp4 が読み取れない場合も不合格。--json を使用すると、失敗時に1行で { ok: false, error, failed: [...] } を出力。実行を開始できない場合も同様(無効な studio.json、不明なフォーマット、不正なフラグ)。 --format 1x1 はそのフォーマットのみを再納品し、他のフォーマットの納品済みファイルとマニフェストエントリは保持(carriedOver)。ゲートに失敗すると、すべての納品済みファイルが取り下げられる。docs/production.json には、タイトル、フォーマット、duration、ラウドネス、ラウンド、最終スコア、労力レベル(CLAUDE_EFFORT が設定されている場合)、ツールバージョンが記録される。

失敗したチェック修正方法
フレーム数またはdurationがずれている、または stale rendernpm run render:final を再実行。部分的なレンダリングを納品してはならない
ラウドネスまたはトゥルーピーク/motion-studio:sound-design(ミックスレポートテーブル)
silenceステムが早期に終了しているか、ベッドが無音で再生されている。再生成して(npm run score、sfx、voice)、npm run mix、再納品
サイズ制限超過node tools/render.mjs --format <f> --final --crf 18 を実行後、npm run mix を再実行
ポスターがないstudio.json の poster(秒)を設定するか、--no-poster を削除
ゲート/motion-studio:critique-loop

ユーザーに報告:out/deliver/ 内のすべてのファイル、マニフェストのフォーマット別数値、最後のラウンドのスコア、次に改善すべき点。

4. パイプラインをユーザー自身のスキルとしてパッケージ化

次の動画が一文で作れるようにする(/acme-reel launch video for dark mode, 20 s, vertical):

  1. 名前を決める:<brand>-reel、小文字、数字、ハイフンのみ。
  2. ブランドのリポジトリに .claude/skills/<brand>-reel/SKILL.md を作成(プロジェクトスコープ、gitで共有)、または ~/.claude/skills/<brand>-reel/SKILL.md(個人用)に作成。${CLAUDE_SKILL_DIR}/assets/brand-skill-template.md から始める(assets/brand-skill-template.md)。
  3. 記憶ではなく、このプロジェクトから記入:studio.json のブランド値、docs/style_guide.md、承認済みの docs/shotlist.md(ストーリービートパターンとして)、docs/review_log.md の教訓(批評家が繰り返し指摘したことはハードルールにする)。ロゴを .claude/skills/<brand>-reel/assets/ にコピー。
  4. 説明は約230文字以内に、具体的なトリガーフレーズを含める。本文は約200行以内に。
  5. 新しいセッションで実際のリクエストを使ってテストし、ビデオごとに変更される項目のみを尋ねることを確認。
  6. 1つのリポジトリを超えて共有するには、プラグインとして公開する(.claude-plugin/plugin.json と skills/<name>/SKILL.md を含むリポジトリ)。buildwithhanif/claude-animation-skill やこのプラグインがその方法で公開されている。

5. サービスとして提供する(オプション)

${CLAUDE_SKILL_DIR}/assets/service-offer.md(assets/service-offer.md)は記入式のオファー:含まれるもの(音楽、任意スタイルのマスコット、製品機能、最後のオファー、任意の言語、最大3回の編集)、フォーマット、納期、クライアントの提供物、権利と開示、価格設定。価格アンカー:Tony Dinh 氏は、Opus 5.5で30分未満で作成する1年前に、同様の起動ビデオに約1,000ドル以上支払ったと報告している(https://x.com/tdinh_me/status/2103703135902740699)。ユーザーが記入するのを手伝う。代わりに公開したり送信したりしない。

次へ:/motion-studio:motion-reel で次のフィルムを開始するか、ユーザーの新しい /<brand>-reel スキルを使用する。

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

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

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

関連スキル