フォーマット出力、スキル、サービス提供(コースステップ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でレンダリングできる。
| フォーマット | サイズ | ラベル |
|---|---|---|
9x16 | 1080x1920 | Reels、TikTok、Shorts |
1x1 | 1080x1080 | X / フィード |
16x9 | 1920x1080 | YouTube、サイト |
4x5 | 1080x1350 | フィードポートレート |
| ツール | 用途 |
|---|---|
L.u | サイズ単位:1080pxの短辺で1。120 * L.u はすべてのフォーマットで同じサイズに見える |
L.S | studio.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:final | out/<fmt>/silent.mp4、poster.png、studio.json の formats にある全フォーマットの render.json |
| ミックスとマルチプレックス | npm run mix | out/score.wav、out/<fmt>/final.mp4、out/final.mp4(プライマリ)、out/poster.png |
| チェックとパッケージング | npm run deliver | out/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 render | npm 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):
- 名前を決める:
<brand>-reel、小文字、数字、ハイフンのみ。 - ブランドのリポジトリに
.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)。 - 記憶ではなく、このプロジェクトから記入:
studio.jsonのブランド値、docs/style_guide.md、承認済みのdocs/shotlist.md(ストーリービートパターンとして)、docs/review_log.mdの教訓(批評家が繰り返し指摘したことはハードルールにする)。ロゴを.claude/skills/<brand>-reel/assets/にコピー。 - 説明は約230文字以内に、具体的なトリガーフレーズを含める。本文は約200行以内に。
- 新しいセッションで実際のリクエストを使ってテストし、ビデオごとに変更される項目のみを尋ねることを確認。
- 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 スキルを使用する。