URLからのプロダクト動画
パイプライン:URL → 抽出 → 概要ドラフト → 盲点質問 → 構築 → レビュー → レンダリング
クリエイティブブリーフのテンプレートは references/video-brief.md にあります。抽出スクリプトは scripts/extract_site.mjs です。ステップ4の前にブリーフテンプレートを読んでください。
1. 環境を確認
node --version # 18以上が必要
任意のウェブサイトを取得し、Chromiumをダウンロードするには、オープンなネットワークアクセスが必要です。Claude Code(ウェブ版)では、環境のネットワークアクセスをFullに設定する必要があります(デフォルトの「Trusted」許可リストはほとんどのクライアントサイトとブラウザダウンロードをブロックします)。ネットワーク/プロキシエラーで取得が失敗した場合は、ユーザーにその旨を1行で伝え、フォールバックします(ステップ2のフォールバックを参照)。
2. サイトを抽出
mkdir -p work && cd work
npm init -y >/dev/null && npm i playwright@1 >/dev/null
npx playwright install --with-deps chromium # root権限がない場合は --with-deps を削除
node <skill-dir>/scripts/extract_site.mjs "<URL>" ./site
これにより、./site/ に以下が書き込まれます:
site.json— タイトル、メタ/OGタグ、見出し、CTA、ナビゲーション、本文テキスト、ランク付けされたブランドカラー、CSSカラー変数、フォント、ロゴ候補、クロールされたサブページhero-desktop.png、hero-mobile.png、full-desktop.png、section-*.png、page-*.pnglogo.*(見つかった場合)
claims は広い網(数字を含むもの全て)です — 使用するクレームのリストではなく、レビューするリストとして扱ってください。
Chromiumがすでに別の場所にインストールされている場合(例:/opt/pw-browsers)、インストールをスキップして PLAYWRIGHT_BROWSERS_PATH をそのパスに設定してください。
次にスクリーンショットを確認(PNGを開く) — JSONだけを信頼しないでください。実際のプロダクトUIが見えるか、あるいはマーケティング画像やストックフォトのみかを判断してください。どのセクションがクローズアップに適した切り抜きになるか?抽出された色は見た目と一致していますか?
フォールバック(ブラウザなし/ブロックされた場合):利用可能な任意のウェブ取得ツールでページテキストを取得し、可能な範囲で埋め、色、ロゴ、スクリーンショットは欠落としてマークします — これらは盲点質問になります。
3. プロジェクト詳細をドラフト
プロジェクト詳細ブロックのすべてのフィールドを埋めてください。各値にそのソースをタグ付けしてください:
[site]— サイトに明記されている(引用またはほぼ引用)[inferred]— サイトから合理的に読み取れる[guess]— 裏付けなし、確認が必要
ルール:
- クレーム: サイトにそのまま記載されているメトリクス/ testimonial/クレームのみを使用し、
[site]とタグ付けしてください。数字、顧客数、結果を決して創作しないでください。サイトに何もない場合、動画にも何もありません。 - 機能: 最も視覚的で具体的な2〜3つを選んでください。画面に表示できない機能は弱い選択です。
- 主な利点: 1文で、ユーザーアウトカムの表現で、会社のタグラインは、それが明確な利点でない限り使用しないでください。
- 色: 抽出結果から控えめなセットを選んでください(背景、テキスト、1つのブランドカラー、最大1つのアクセントカラー)。16進コードを指定してください。
- アセット:
./site/からの実際のファイルパスをリストし、それぞれが何を示しているかを説明してください。
4. 盲点質問を一度にまとめて行う
構築を始める前に、起草した詳細ブロックと質問を含む1つのメッセージを送信してください。ルール:
- 動画を変え、サイトから解決できなかったことのみを質問してください。すでに明確なことはスキップしてください。
- すべての質問にはあなたの提案するデフォルト値を添えて、ユーザーが「go」と返信すれば先に進めるようにしてください。
- 最大約6問、影響度順に並べてください。簡潔に。
これらの盲点を確認してください(該当するものだけ質問):
- 目的 — ビジネス向けのコールドピッチサンプル、有料広告、ポートフォリオ作品、それともローンチ動画?(CTA、トーン、アスペクト比が変わります。)
- アスペクト比 — 9:16(Reels/TikTok/DM) vs 16:9(ウェブサイト/YouTube/LinkedIn)。デフォルト:ピッチ/広告の場合は9:16、サイト埋め込みの場合は16:9。
- 視聴者 — サイトが複数の対象者にサービスを提供している場合(例:買い手と売り手)、どちらを対象としますか?
- 機能の選択 — 候補が3つ以上ある場合、あなたの選択を確認してください。
- プロダクトビジュアル — スクリーンショットに実際のUIがなく(写真やイラストのみ)、簡略化された再現UIを使用するか、彼らの写真を使用するか、またはユーザーが実際のアプリのスクリーンショットを持っているかを質問してください。
- ロゴ — 欠落、低解像度、またはファビコンのみ → ブランドフォントからクリーンなワードマークを構築しますか?
- クレーム — サイトに統計/ testimonialがある場合:それらを含めますか(そのまま)、それともクレームなしにしますか?
- CTA — サイトに明確なCTAがない、または目的がピッチの場合 → エンドカードに何を表示/リンクすべきですか?
- 物理的/ローカルビジネスでアプリがない場合 → デバイスモックアップは適さないため、代替の中心的なビジュアル(彼らの写真、予約/メニューカード、マップピン)を提案してください。
- 音楽/ナレーション — ブリーフは無音動画です。ユーザーの目的がサウンドを暗示する場合にのみ言及してください(広告など)。
ユーザーが「そのまま進めて」または部分的にしか答えない場合は、あなたのデフォルト値を使用し、1行でそれを明記してください。
5. ブリーフを記入して実行
references/video-brief.md を読んでください。確認されたプロジェクト詳細(ソースタグは削除)を挿入し、work/brief.md として保存してください。次にブリーフを自身の指示として従ってください:まずストーリーボードを作成(簡潔に表示、ユーザーがレビューを求めた場合を除き承認を待つ必要なし)、次に構築します。
Remotionのセットアップ(非対話式)
mkdir video && cd video
npm init -y >/dev/null
npm i remotion @remotion/cli react react-dom
npm i -D typescript @types/react
npx remotion browser ensure
mkdir -p src public && cp ../site/*.png ../site/logo.* public/ 2>/dev/null
すべての remotion / @remotion/* パッケージは完全に同じバージョンでなければなりません。エントリ:src/index.ts が registerRoot(Root) を呼び出し、src/Root.tsx が <Composition> を登録します。アセットは staticFile('name.png') と <Img> で参照します。ブランドフォントがGoogleフォントの場合は @remotion/google-fonts でウェブフォントを読み込み、そうでない場合は近いフォールバックを使用します。
構造:
src/content.ts— すべてのコピー、色、アセットファイル名、シーン長(秒単位)。これはユーザーが編集するファイルです。src/scenes/*.tsx— シーンごとに1つのコンポーネント。src/components/*— デバイスフレーム、テキストリビールなど。- 合計時間は
content.tsのシーン長から計算されます。
シーンには interpolate + spring(remotionから)、<Sequence> または @remotion/transitions の <TransitionSeries> を使用してください。CSSアニメーションや Math.random()(非決定論的なレンダリング)は使用せず、必要な場合はremotionの random('seed') を使用してください。
6. 最終レンダリング前にレビュー
代表的なフレーム(各シーンの開始、中間、終了)で静止画をレンダリングして確認します:
npx remotion still src/index.ts <CompId> out/f-<n>.png --frame=<n>
ブリーフのレビューリストと照らし合わせて確認:電話サイズで読めるテキスト、クリップされていないもの、シーンごとに1つの焦点、スクリーンショットが引き伸ばされていないこと、終了ホールドが1.5秒以上であること。修正し、変更したフレームを再確認してください。
7. レンダリングと納品
npx remotion render src/index.ts <CompId> out/<product>-video.mp4
納品:MP4パス、ブリーフストーリーボード(簡潔)、および4行の編集ノート — コピー/色/長さは src/content.ts に、アセットは public/ にあり、プレビューは npx remotion studio、再レンダリングは上記のコマンドで行います。あなたが想定したデフォルト値を1行で明記してください。