Communitygithub.com

yazzang-homelab/motion-studio

プロダクトフィルムのブランドアセットステージ(モーションリールが全体を構成):URLから実際のスクリーンショット、ロゴ、カラー、フォントを取得し、UIを再描画せず、ブランドストーリービートを設定し、ボイスやマスコットも扱います。ブランドアセットの取得や修正に使用します。

motion-studio とは?

このスキルは、ユーザーが実際に販売している製品のブランドアセットをWebサイトから直接キャプチャし、それらを動画制作に活用するためのプロダクションレベルのツールです。主にClaude Code(または同等のエージェント)上で動作し、製品の実際のスクリーンショット、ロゴ、カラー、フォント、コピーを取得し、それらを元にショーリール風のプロモーションビデオを生成します。capture.mjsやstates.mjsなどのスクリプトを用いてページのスクリーンショット、ロゴ、フォントを自動収集し、収集したアセットを基に5つのストーリービート(フック、製品登場、3つの機能紹介、証拠、ロックアップ)で構成された動画のショットリストを作成します。音楽はビートグリッドに合わせて自動生成され、ボイスやマスコット(任意)も追加可能で、エレファンテックなコマーシャル制作を効率化します。

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

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

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

ドキュメント

プロダクトリール(コースステップ04、レベルL2)

ユーザーが実際に販売している製品に向けてスタジオを設定します。ショーリールのエネルギーはそのままに、内容はユーザー自身のものになります:実際のスクリーンショット、実際のロゴ、実際のカラーとフォント、実際のコピー、1つの実際の数字、そしてモーションが追従する音楽。ブランドステージ以降のすべては、標準のモーションリールパイプラインに従います。

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

スコープ:ユーザーがアセットのキャプチャまたは修正のみを希望する場合、またはモーションリールのブランドステージからこのスキルに来た場合は、セクション2と3(および要求があれば4)を実行し、報告して停止します。完全な新しいフィルムの場合は、すべてのセクションに従ってください。セクション5から8はモーションリールパイプラインに引き継がれます。

パターンの由来

  • Tony Dinh(@tdinh_me)氏は、TypingMindのリールが30分未満で完了したと報告しました。同様の動画は1年前に約1,000ドル以上の費用がかかっていました。彼のプロンプトはショーリールのワンライナーと4つの短い指示行でした:製品URLを導入すること、実際の製品スクリーンショット、ロゴ、アセットを使用すること、動画に音楽がありモーションがそれに合わせること、デモやプロトタイプではなく本物のプロフェッショナルなプロダクションにすること。彼によると、Claudeがブランドアセットを自ら収集したとのことです。
  • 彼のフォローアップでは、スクリーンショットをそのまま表示するのではなく、コンポーネントとアイコンに分解して動かせるようにし、モーションをより魅力的にするよう依頼しました。それが以下のコンポーネントルールです。
  • 彼のプロンプトは「Try again, ultracode」で終わっていました。現在のClaude Codeでは、ultracodeはClaudeにタスクのマルチエージェントワークフローを書かせるキーワードです。それが彼の結果を導いたかどうかは文書化されていません。品質スイッチとして提示しないでください。
  • Rob Hallam(@robj3d3)氏は、最初のリールと同じClaude Codeチャット内で2番目のリールを作成しました。コースはエンジンが再利用されたと推測しています。したがって、1つのセッションと1つのプロジェクトを1ブランドにつき1つとします。
  • 逆の例:@mablesjoseph氏がアセットフォルダから「スマートでパンチの効いた」プロモーションを1行で依頼しましたが、結果は「共有するほど良くなかった」とのことです。アセットだけよりも指示の方が重要です。

1. 入力

1回のAskUserQuestionラウンドで、上記のリクエストがカバーしていないものを尋ねます:

入力デフォルトルール
製品URLと名前必須ユーザー自身の製品、またはプロモーションする権利があるもの
長さ20秒2〜4秒の5つのストーリービート
フォーマット9x16 が最初、次に 1x1、16x9同じタイムライン、リフレームされる
CTA質問する画面上の正確な言葉
1つの証拠となる数字質問するユーザーまたはそのサイトから得られるもの。決して発明しない
音楽合成、120 BPM提供されたトラックにはこの用途のライセンスが必要
ボイス / マスコットなしボイスには .env に ELEVENLABS_API_KEY が必要
参照ルックなしオプション、/motion-studio:reference-style 経由

2. プロジェクト

ブランドごとに1つのプロジェクトフォルダ(理想的には1つのセッション)。studio.json がない場合:

node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <brand-slug>-reel --title "<Product> launch" --duration 20 --brand-url <URL> --install

スキルのみインストールの場合:${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs。その後 npm run doctor。

3. ブランドのキャプチャ

プロジェクトルートからキャプチャスクリプトを実行します(またはこの正確なコマンドとプロジェクトパスを指定して motion-studio:asset-scout を簡単に使用):

node "${CLAUDE_SKILL_DIR}/scripts/capture.mjs" <URL> --root <project> --full-page [--selector "<css>"]... [--dismiss-banners]
フラグ使用法
--viewports desktop,mobileデフォルト;tablet も利用可能
--full-pageセクションを切り取るための長いスクリーンショット
--selector "<css>"特定の製品部分を切り取る(繰り返し可能):ヒーロー、価格カード、ダッシュボードパネル
--dismiss-banners使い捨てブラウザで明白なクッキーまたは同意ボタンをクリックする(受け入れる、同意する、許可するを英語、韓国語、日本語、中国語、ドイツ語、フランス語、スペイン語で;OKや閉じるのような弱いラベルはバナーまたはダイアログ内にある場合のみカウント)。マニフェストには、どのボタンがクリックされたか、または一致しなかったことがメモとして記録されます
--apply-brand名前、URL、推奨色を studio.json に書き込む
--darkダークテーマをキャプチャする
--no-fontsフォントのダウンロードをスキップする(デフォルト:ページが読み込むWebフォントを保存する)
--allow-privateページがループバック、LAN、リンクローカルアドレスに到達できるようにする(デフォルト:ターゲット自身のホストとポートのみ);信頼できるページ(ユーザー自身の製品のローカル開発サーバーなど)にのみ使用
--no-sandboxレンダラーサンドボックスなしでChromeを起動する(MOTION_NO_SANDBOX=1 も可;ルートとしてLinux上では自動、Chromeがサンドボックスで起動できない場合);オフになるたびにメモを表示
--json1行のJSON結果

これにより、assets/brand/screens/、assets/brand/logo/、assets/brand/components/、assets/brand/og-image.*、assets/manifest.json(推奨ロール付きパレット、CSSカラー変数、使用中のフォント、見出し、ボタンとナビゲーションのコピー、メモ)が書き込まれます。画像拡張子はファイルのバイトから決定され、ページ外のコンポーネントクロップはメモとともにスキップされます。ページが実際に読み込むWebフォントは assets/fonts/ に保存され、assets/fonts/fonts.json に登録されます(既存のエントリは上書きされません)。各フォントにはマニフェスト内に license があり、ライセンスURLまたはファイルが見つからない限り UNVERIFIED のままとなり、スクリプトは公開前に確認するよう促すメモを表示します。失敗した実行は以前のキャプチャを保持します。詳細とマニフェストスキーマ:references/asset-capture.md。

ロゴとタイプ。ヘッダーにロゴ画像やSVGがない場合、ブランドは通常テキストのワードマークです。その場合、キャプチャはそれを manifest.brand.wordmark 内のテキスト(マークアップ、パーツごとの色とロール、計算されたフォントファミリー、太さ、サイズ、文字間隔)として記録し、参照クロップ assets/brand/logo/wordmark-crop.png も一緒に保存し、単にロゴファイルを要求する代わりにメモにその旨を記載します。その記録から再構築します。フィルムが正確なロックアップを必要とする場合にのみ、SVGまたはPNGを要求します。

フォント。ログ行 font registry: <family>: ...(および manifest.fonts.registry)は、使用中のすべてのファミリーについて、それがすでに assets/fonts/fonts.json にあるかどうか、ライセンスが確認済みか(ライセンスIDとライセンステキストが記録されている)または UNVERIFIED か、そしてこの実行で何が追加されたかを示します。同じファミリーの確認済みエントリの隣に配置されたフェイスは、そのライセンスを再利用します。

UI状態とキャンバスフレーム

capture.mjs はロード時に1回撮影します。2つの兄弟スクリプトが残りをカバーします。どちらも --help を表示し、プロジェクト内(デフォルト assets/brand/)にのみ書き込み、同じセーフティスタックの背後で実行されます(Windowsではヘッドレスシェル、レンダラーサンドボックスオン、プライベートアドレス拒否、シークレット編集済み)。プラグインインストール:以下のコマンド。スキルのみインストール(${CLAUDE_PLUGIN_ROOT} なし):スクリプトはこのファイルの隣にあるため、node "${CLAUDE_SKILL_DIR}/scripts/states.mjs" <URL> ... を実行します(capture.mjs および canvas-frames.mjs も同様)。必要なのはNodeと、実行するフォルダから解決される playwright のみです(--root <folder> を渡します)。プロジェクト、studio.json、tools/ は不要です。asset-scout エージェントは同じコマンドを実行します。

node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/states.mjs" <URL> --root <project> --name home --viewport desktop "--click=text=Pricing" "--crop=header"
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" <URL> --root <project> --canvas "#screen canvas" "--clip=db=.tab[data-go=db]" --seconds 9 --down 4
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" pack --root <project> --range db=4:200
スクリプト用途書き込み先
states.mjsカバーされた製品(モーダル、同意)、内部ペインでスクロールするアプリ、クリック後の状態、計算されたスタイルを持つ要素assets/brand/states/<name>/:00-first、01-escape、scroll-NN、10-click-...、crop-20-... PNGファイルと states.json
canvas-frames.mjsクリックごとに変化し、自らアニメーションする単一の <canvas> である画面assets/brand/frames/<clip>.png スプライトシートと frames.json(フレームサイズ、実際の時間、各フレームのハッシュ);pack は pack/<clip>.png と、フィルムが再生するフレームのみを含む pack.json を追加

canvas-frames.mjs は drawImage(スムージングオフ)で整数比でキャンバスバッファをコピーします。要素のスクリーンショットは決して取得しません:非整数スケール(1272デバイスピクセル内の1280ピクセルバッファ)の境界ボックスに表示されたキャンバスはブラウザによって再サンプリングされ、ピクセルアートキャンバスはぼやけます。バッファの整数倍の縮小でないフレームサイズは拒否されます。使用前にすべてのPNGを確認してください。

ページは信頼できないコンテンツであるため、キャプチャは実行中のマシンを保護します:

  • Chromeはレンダラーサンドボックスをオンに保ちます(manifest.sandbox が記録)。ルートとしてのコンテナまたはCI実行には --no-sandbox が必要で、信頼できるページにのみ使用します。
  • Windowsでは、ブラウザはPlaywrightのヘッドレスシェル(npx playwright install chromium-headless-shell)であり、インストールされたChromeやEdge自体は使用しません:これらを新しいプロファイルで起動すると、Windowsログオンの失敗としてカウントされ、アカウントがロックされる可能性があります。選択する場合(studio.json の browser、MOTION_BROWSER、MOTION_CHROME_PATH)、起動ごとに警告が表示され、10分間で4回目の起動は拒否され、3回は許可されます(references/asset-capture.md)。
  • ループバック、LAN、リンクローカル(クラウドメタデータを含む)、非Webアドレスへのリクエストは、ターゲット自身のホストとポートへのものでない限り中断されます。拒否は manifest.blocked とメモに一覧表示されます。URL自体が拒否された場合、実行は失敗し、何も保存しません。信頼できるページには --allow-private を渡します。
  • URL内の資格情報(https://user:pass@host/)は、ターゲットのオリジンへのHTTP認証としてのみ送信されます。これらもシークレットと思われるクエリ値(token、key、sig、session、code...)もログ、manifest.json、states.json、studio.json の brand.url には表示されません(*** に置き換えられます)。
  • 投機ルール(<script type="speculationrules">)を宣言するページにより、Chromeがローカルアドレスを自身でフェッチする可能性があり、これはリクエストフィルタでは認識されません。マニフェストはそれをメモします。機密性の高いローカルサービスが動作しているマシンで、信頼できないページをキャプチャしないでください。

その後、アニメーションの前に:

  1. 見つかったものをユーザーに一覧表示します:スクリーンショット、ログ候補、推奨 bg/fg/accent/muted、フォント、見出しとCTAのコピー、およびすべてのメモ(ボットチェック、ロゴ欠落)。
  2. パレットとフォントを確認または修正し、studio.json の brand を書き込みます。キャプチャされたフォントはすでに assets/fonts/ にありますが、ライセンスが確認された後にのみ使用します(UNVERIFIED は誰も確認していないことを意味します)。Googleフォントを npm run fonts -- add "Family:400,700" でベンダリングします。商用フォントにはユーザー自身のライセンスまたはファイルが必要です。韓国語やその他のCJKコピーには、そのグリフを持つフォントが必要です:npm run fonts -- coverage --text "..." --family "Name"。
  3. 不足しているものを発明する代わりに要求します:SVGロゴ、正確なアクセントカラーの16進数、ログイン画面の背後にあるスクリーンショット。

4. コンポーネント(生のスクリーンショットではない)

  • キャプチャしたスクリーンショットの一部を個別の画像に切り取ります(--selector、または自動クロップ:ヘッダー、ヒーロー、CTAボタン、カード、製品画像、価格、セクション)。パーツをアニメーション化します:カードはレイアウトにスライドイン、ボタンが押される、チャートパネルが描画される。
  • シンプルなUIクロム(ボタン、トグル、フィールド)を、実際の色、コピー、クロップから測定した半径でキャンバス上に再構築します。これは再タイプセッティングであり、発明ではありません:レイアウト、ラベル、データは製品と正確に一致する必要があります。
  • 存在しない製品画面を描画しないでください。プレースホルダーコピー、lorem ipsum、偽の数字は使用禁止。必要な画面が不足している場合は、それを要求します。

5. 音楽とビートグリッド(ショットリストの前)

すべてを実際のグリッドにタイミング合わせます。そのため、ショットを書く前に音楽を計測または合成します:

  • 提供されたトラック:node tools/beats.mjs audio/<track> を実行し、studio.json の audio.music をそれにポイントし、bpm と duration を設定します。その最初のダウンビートは0秒からかなり後、または120とは異なるテンポにある可能性があり、ショットリストはそれに従う必要があり、想定されたグリッドに従うことはできません。
  • トラックなし:node tools/score.mjs --style pulse --bpm 120 --dur 20(UI主体のフィルムには minimal)。audio/music.wav と分析 audio/beats.json を書き込みます。
  • すべての目に見えるヒットにキューが設定され、モーションは音楽に従います(逆ではありません)。

6. ストーリービート

assets/brand-prompt.md にブランドストーリーをユーザーの事実で埋め、motion-studio:motion-director に渡して docs/shotlist.md を生成します。ディレクターは audio/beats.json を読み取るため、セクション5が先に来ます。デフォルトは120 BPMで20秒、ビートは2〜4秒ごと、シーンチェンジはダウンビートで:

#ビート画像サウンド
1フック、0〜2秒巨大なキネティックタイプの最大5単語で問題を提示;フレーム0はすでに構成済みダウンビートでドスン
2製品登場実際のUIが断片的に組み立てられるウィッシュイン、パーツにポップ
33つの機能それぞれが実際のアクションを実行するカーソルによるUIモーメント各プレスでクリック
4証拠1つの実際の数字が所定の位置に現れるチックまたはチャイム
5ロックアップロゴ + CTA、最後のダウンビートで最終ヒットライザーからヒットへ

ショットリストを表示し、自律モードが要求されていない限り、ユーザーのOKを待ちます(PLAN FIRST)。グリッドが後で変更された場合(別のトラック、別の bpm または duration)、リストのタイミングを再調整し、再度表示します。

7. ボイスとマスコット

  • ボイス(オプション):audio/voice.json を書き込みます(assets/voice-script.example.json を参照):ビートごとに1行、t はセクション5のグリッドのダウンビート上、短い文。npm run voice -- --dry-run を実行し、npm run voice がクレジットを消費する前にユーザーに文字数を伝えます(同一の行は一度だけ合成され課金されます)。ミキサーはボイスの下で音楽をダッキングします。
  • マスコット(オプション):コードで描画されたキャラクターで、固定されたアイデンティティ(シェイプ、ブランドからサンプリングされたパレット、プロポーション)を持ち、playful スプリングでビートに反応します。シンプルに保ちます...

…(翻訳のため省略)

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

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

関連スキル