Communitygithub.com

ビデオストーリーボード

エージェントが「ビデオストーリーボード」の計画、作成、または編集を行うための手順を提供し、具体的な成果物としてビートシートとショットリストを生成します。手順は、ビデオストーリーボード、運用手順、ステップ1(一行の目的とプラットフォームの確定)を通じて進みます。新しいタスクがこの技術を必要とする場合に使用します。

ビデオストーリーボード とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)がデモビデオやローンチビデオの制作前に、構造化されたストーリーボード計画を作成するための完全なワークフローを提供します。まず、視聴者が覚えるべき一行のメッセージ(「ワンテイクアウェイ」)とターゲットプラットフォーム(ランドスケープ、ポートレート、スクエア)を確定し、それに基づいてランタイムとアスペクト比を決定します。次に、フック、問題、リビール、証明、CTAの5つのビートからなるビートシートを構築し、各ビートにシーンタイプ(タイトル、テキスト、UI、証明、CTA)と推奨時間を割り当てます。さらに、各シーンにコピーとビジュアル説明を含むショットリストを作成し、最終的にはJSON形式のシーンプラン(`scene-plan.json`)を生成します。このJSONは、Remotionベースのツールチェーン(`remotion-compose`など)が直接読み取り、動画の構成とレンダリングに使用します。Remotion環境で動作し、特に製品デモやローンチビデオの計画段階で威力を発揮します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ensinohi-lab/thesis-skills/tree/HEAD/video-storyboard

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

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

ドキュメント

ビデオストーリーボード は何をしますか?

1フレームのアニメーションを作成する前に、これを実行すること。 デモビデオの成否はその計画にかかっています。順序が間違っていたり、フックが欠けていたり、ランタイムが40秒を超えていたりすると、どんなに動きが洗練されていても台無しになります。あなたは、どのシーンが存在し、どの順序で、どれだけの時間表示され、それぞれが何を語るのかを決定し、具体的なシーン計画をメカニクスパック(remotion-setup、remotion-compose、remotion-render)に引き渡すクラフトレイヤーです。

計画意図に対して積極的に機能を発動させてください。「デモをストーリーボード化して」「ビデオを計画して」「どのシーンが必要?」「ローンチビデオをマッピングして」「この機能をシーンに分割して」といった指示に対応します。ユーザーが「これをアニメーション化して」と直接指示した場合でも、最初にビートシートを実行してください。ストーリーボードは2分で完了し、再レンダリングを防ぎます。

以下の例を全体で使用します。AIコードレビューツール Sentinel(マージ前にリスクのある差分をフラグ付けするツール)の30秒ローンチビデオ。

運用手順

以下の順序で実行してください。ビートが確定する前にコピーを書かず、ビートが存在する前に時間を設定しないでください。ペーシングは構造の関数であり、その逆ではありません。

ステップ1 - 一行の目的とプラットフォームを確定する

ビートの前に、次の2つを固定します。

  1. 単一のテイクアウェイ。 視聴者が覚えておくべき一文:「Sentinelは、あなたのレビューアが見逃したバグをキャッチします。」一文で言えなければ、ビデオに背骨はありません。後続のすべてはこの一文に奉仕します。
  2. プラットフォームとアスペクト比。 サイトのヒーローやYouTubeにはランドスケープ16:9(1920×1080)。ソーシャル/Shortsには縦9:16(1080×1920)。フィードにはスクエア1:1。これにより、remotion-composeが作成するキャンバスが設定され、ランタイムの上限が決まります。ソーシャルは15〜30秒、ヒーローループは20〜40秒、機能のウォークスルーは最大60秒までです。

ステップ2 - ビートシートを敷く(5ビートの背骨)

すべてのデモ、アナウンスメント、ローンチビデオは、これら5つのビートのバリエーションです。理由があってビートを削除するのは構いませんが、フックの順序を変更してはいけません。

  1. フック(最初の3秒)。 ビデオの中で最も重要な3秒。視聴者はここで視聴を続けるかどうかを決定します。ロゴではなく、結果、緊張感、または大胆な主張で始めてください。「あなたのレビューアがバグを承認しました」は「Sentinelのご紹介」よりも優れています。ロゴは隅に配置しても構いませんが、それがフックであってはなりません。
  2. 問題。 視聴者がすでに感じている痛みを具体的に名前付けます。「金曜日の午後5時、危険な差分がレビューをすり抜けます。」1ビート、1つの痛み。
  3. リビール。 製品を転換点として紹介します。ここで名前とコアメカニズムが登場します。製品が実際に動作している様子を見せます。
  4. 証明。 主張を信頼できるものにします。実際のビフォー/アフター、実際の数字、実際のスクリーンショット。多くのビデオがこのビートをスキップしますが、これこそがコンバージョンにつながるビートです。実際の製品データを使用し、決して作り上げた指標を使用しないでください。
  5. CTA。 1つのアクション、1つのURL。「Sentinelを無料で試す→sentinel.dev」。2つの依頼は絶対に避けてください。

より長いウォークスルーの場合、リビールと証明のビートは機能ごとに繰り返します(リビール機能1→証明、リビール機能2→証明)。フック、問題、CTAは単一のままです。

ステップ3 - 各ビートにシーンタイプと目標時間を割り当てる

各ビートは1つ以上のシーンになります。シーンタイプがペーシングを決定します。テキストには読む時間が必要で、UIデモには留まる時間が必要で、ロゴは高速です。以下の目標値を使用します(30fpsの場合。durationInFrames = 秒 × fps)。

シーンタイプ目標時間理由
フック / タイトルカード2.5〜3.5秒1行を読むのに十分な長さでありながら、冒頭をタイトに保つのに十分短い
テキストステートメント2.5〜4秒読む速度は約2.5ワード/秒。7ワードの行は約3秒の表示時間が必要
UI / 製品デモ4〜6秒目が画面とその中の動きを解析するのに留まる時間が必要
証明 / データ3〜5秒数字やビフォー/アフターは、認識するための一拍が必要
ロゴ / CTAアウトロ2.5〜4秒URLを読み、余韻を残し、終了する

ペーシングルール:フックは最も速いカット、証明は最も遅いカット。 合計時間が長くなりすぎた場合は、シーンを削除してください。すべてのシーンを速くしないでください。急いだデモは、落ち着きがない印象を与えます。

ステップ4 - ショットリストを書く(シーンごとのコピー+ビジュアル)

各シーンについて、4つのフィールドを確定します。そのシーンがサービスするビート、シーンタイプ、画面上のコピー(実際の言葉。ユーザーに尋ねてください。決して主張をでっち上げないでください)、そしてremotion-composeに何をレンダリングするかを指示する1行のビジュアル説明です。これが成果物です。ビジュアルの行はブリーフであり、コードではありません。「ターミナルがgitの差分を入力し、リスクのある行が赤くハイライトされる」— remotion-composeがinterpolate/springのメカニクスを決定します。

ステップ5 - JSONシーンプランを出力する

以下のジェネレーターを実行して、ショットリストを構造化されたscene-plan.jsonに変換します。これが引き渡す成果物です。remotion-composeはこれをシーンプランとして読み取ります(各シーンに1つの<Sequence>、from/durationInFramesはすでに計算済み)。シーンごとのmotionヒントは、motion-design-principlesやmotion-color-and-lightの判断が介入する場所です。プロジェクトの隣に保存して、メカニクスパックがそれを取得できるようにします。

ステップ6 - 引き渡し

ユーザーにビートシート、ショットリストの表、JSONを提示します。その後、明示的に引き渡します。「こちらがシーンプランです。プロジェクトがまだスキャフォールディングされていない場合はremotion-setupを、次にremotion-composeがこのJSONをコンポジションに変換し、remotion-renderがエクスポートします。アニメーション化する前に、ペーシングやコピーを調整しますか?」ビデオが特に製品デモであり、各シーンで何を表示するかについてディレクターの視点が必要な場合は、product-demo-directorとペアリングしてください。キネティックタイトル処理はkinetic-typographyへ。サウンドベッドとビート同期カットはsound-and-music-syncへ。ソーシャル向けの縦型再編集はsocial-video-formatterへ。

品質基準

ストーリーボードは、以下のすべてが満たされた場合にのみA+と評価されます。

  • フックが最初の3秒以内に着地し、ロゴではない。結果、緊張感、または主張で始まる。
  • 5つのビートすべてが存在するか、欠落している各ビートに理由が明記されている(ティーザーでは正当に証明を省略できる場合がある)。
  • すべてのシーンに実際の言葉によるコピー行と、具体的なビジュアルブリーフがある。「ここにUI」「一部のUI」のようなものや、でっち上げた指標がない。
  • 合計ランタイムがプラットフォームの上限に収まっており、時間はシーンタイプの表に従っている(フックは速く、証明は遅く)。一律3秒カットではない。
  • CTAは単一のアクション、単一のURLである。
  • JSONが検証され、その合計時間がremotion-composeが登録するコンポジションの合計と一致している。不一致はレンダリングの驚きの第1位です。

禁止事項

  • ロゴやスローフェードインのタイトルで始めてはいけません。フックの前に視聴者を失います。
  • 証明ビートのために数字、推薦文、製品の主張をでっち上げてはいけません。実際のデータを求めるか、ビートを削除してください。
  • .tsxを書いたり、interpolateの範囲を選択したり、springのdampingをここで設定してはいけません。それはremotion-composeの役割です。このスキルは計画を出力し、コードを出力しません。
  • すべてのシーンを同じペースにしてはいけません。一律3秒のカットは、デモをスライドショーのように感じさせます。
  • 2つのCTAや2つのURLを重ねてはいけません。1つの依頼がコンバージョンにつながり、2つは注意を分割します。
  • ランタイムをプラットフォームの上限を超えて引き延ばしてはいけません。代わりにシーンを削除してください。

ジェネレーター

自己完結型のNodeスクリプト。scene_plan.jsとして保存し、該当するビデオのbeats配列を編集し、node scene_plan.js > scene-plan.jsonを実行してください。依存関係はありません。フレームオフセットを計算し、合計を検証し、remotion-composeが消費する計画を出力します。

// ストーリーボード→シーンプラン。`meta`と`beats`を編集し、次のコマンドを実行:
//   node scene_plan.js > scene-plan.json
const meta = {
  title: 'Sentinel Launch',
  fps: 30,
  width: 1920,   // 縦9:16の場合は1080、スクエアの場合は1080
  height: 1080,  // 縦9:16の場合は1920、スクエアの場合は1080
}

// シーンごとに1行。`seconds`はシーンタイプの表に従います。
// `motion`はmotion-design-principles / motion-color-and-lightへのヒントです。
// コードではなく、ブリーフです。
const beats = [
  { beat: 'hook',    type: 'title',   seconds: 3.0, copy: 'あなたのレビューアがバグを承認しました。', visual: '暗い画面、コードの行が入力される。1行が赤くスナップする。', motion: 'スナッピー、赤いフラグのダンピングは低め' },
  { beat: 'problem', type: 'text',    seconds: 3.5, copy: '金曜日の午後5時、危険な差分がレビューをすり抜けます。', visual: 'カレンダー/時計のモチーフ、マージ済みとマークされたPR。', motion: '穏やかなフェード、オーバーシュートなし' },
  { beat: 'reveal',  type: 'ui',      seconds: 5.0, copy: 'Sentinelはマージ前にすべての差分をレビューします。', visual: 'Sentinelが同じ差分をスキャンし、理由とともにリスクのある行を表示する。', motion: 'スキャンスイープ、その後落ち着く' },
  { beat: 'proof',   type: 'proof',   seconds: 4.5, copy: '実際のPRでキャッチ。出荷される前に。', visual: 'ビフォー/アフター:赤フラグ→修正済み差分、実際のスクリーンショット。', motion: 'スロークロスディゾルブ、ホールド' },
  { beat: 'cta',     type: 'cta',     seconds: 3.0, copy: 'Sentinelを無料で試す→sentinel.dev', visual: 'ブランドカラーにロゴ+URL。', motion: '優しいポップ、クリーンに終了' },
]

const fps = meta.fps
let from = 0
const scenes = beats.map((b, i) => {
  const durationInFrames = Math.round(b.seconds * fps)
  const scene = {
    id: `${i + 1}-${b.beat}`,
    beat: b.beat,
    type: b.type,
    from,
    durationInFrames,
    seconds: b.seconds,
    copy: b.copy,
    visual: b.visual,
    motion: b.motion,
  }
  from += durationInFrames
  return scene
})

const durationInFrames = from
const totalSeconds = durationInFrames / fps
const hook = scenes[0]
const warnings = []
if (hook.beat !== 'hook') warnings.push('最初のシーンがフックではありません。')
if (hook.seconds > 3.5) warnings.push('フックが3.5秒より長いです。冒頭をタイトにしてください。')
if (scenes.filter((s) => s.beat === 'cta').length > 1) warnings.push('複数のCTAがあります。')
if (!scenes.some((s) => s.beat === 'proof')) warnings.push('証明ビートがありません。主張がコンバージョンにつながらない可能性があります。')
if (totalSeconds > 60) warnings.push(`ランタイム${totalSeconds}秒が60秒の上限を超えています。シーンを削除してください。`)

const plan = {
  composition: {
    id: meta.title.replace(/[^A-Za-z0-9]/g, ''),
    fps,
    width: meta.width,
    height: meta.height,
    durationInFrames, // remotion-composeはこれを<Composition>に正確に登録します
  },
  scenes,
  meta: { totalSeconds, sceneCount: scenes.length, warnings },
}

process.stdout.write(JSON.stringify(plan, null, 2) + '\n')
if (warnings.length) console.error('WARNINGS:\n  - ' + warnings.join('\n  - '))

ワークドサンプル出力

上記のbeatsを使用すると、スクリプトはscene-plan.jsonを書き込みます:

{
  "composition": {
    "id": "SentinelLaunch",
    "fps": 30,
    "width": 1920,
    "height": 1080,
    "durationInFrames": 570
  },
  "scenes": [
    { "id": "1-hook",    "beat": "hook",    "type": "title", "from": 0,   "durationInFrames": 90,  "seconds": 3.0, "copy": "あなたのレビューアがバグを承認しました。", "visual": "暗い画面、コードの行が入力される。1行が赤くスナップする。", "motion": "スナッピー、赤いフラグのダンピングは低め" },
    { "id": "2-problem", "beat": "problem", "type": "text",  "from": 90,  "durationInFrames": 105, "seconds": 3.5, "copy": "金曜日の午後5時、危険な差分がレビューをすり抜けます。", "visual": "カレンダー/時計のモチーフ、マージ済みとマークされたPR。", "motion": "穏やかなフェード、オーバーシュートなし" },
    { "id": "3-reveal",  "beat": "reveal",  "type": "ui",    "from": 195, "durationInFrames": 150, "seconds": 5.0, "copy": "Sentinelはマージ前にすべての差分をレビューします。", "visual": "Sentinelが同じ差分をスキャンし、理由とともにリスクのある行を表示する。", "motion": "スキャンスイープ、その後落ち着く" },
    { "id": "4-proof",   "beat": "proof",   "type": "proof", "from": 345, "durationInFrames": 135, "seconds": 4.5, "copy": "実際のPRでキャッチ。出荷される前に。", "visual": "ビフォー/アフター:赤フラグ→修正済み差分、実際のスクリーンショット。", "motion": "スロークロスディゾルブ、ホールド" },
    { "id": "5-cta",     "beat": "cta",     "type": "cta",   "from": 480, "durationInFrames": 90,  "seconds": 3.0, "copy": "Sentinelを無料で試す→sentinel.dev", "visual": "ブランドカラーにロゴ+URL。", "motion": "優しいポップ、クリーンに終了" }
  ],
  "meta": { "totalSeconds": 19, "sceneCount": 5, "warnings": [] }
}

解釈:5シーン、570フレーム=30fpsで19秒。ソーシャルの上限をはるかに下回っています。フックは3秒で、ロゴではなく緊張感から始まります。証明ビート(4.5秒)が最も遅いカットで、フックとCTA(3秒)が最もタイトです。警告はないため、remotion-composeの準備が整いました。remotion-composeは<Composition durationInFrames={570}>と、各シーンに1つの<Sequence from={…} durationInFrames={…}>を登録し、fromとdurationInFramesをこのファイルから直接読み取ります。

テンプレート:ショットリスト

JSONと並べて人間が読める表が必要な場合に使用します。FILLフィールドを実際のビデオに置き換えてください。

VIDEO STORYBOARD. [FILL: ビデオ名]. [FILL: プラットフォーム / アスペクト比]
目的(一行):       [FILL: 単一のテイクアウェイ]
目標ランタイム:     [FILL: ソーシャル15〜30秒 / ヒーロー20〜40秒 / ウォークスルー最大60秒]

BEAT      SCENE TYPE   DURATION   ON-SCREEN COPY (real words)        VISUAL BRIEF
フック      title        [FILL]s    [FILL: 結果/緊張感/主張]        [FILL]
問題       text         [FILL]s    [FILL: 1つの具体的な痛み]         [FILL]
リビール    ui           [FILL]s    [FILL: 製品 + コアメカニズム]   [FILL]
証明       proof        [FILL]s    [FILL: 実際の数字 / ビフォーアフター][FILL]
CTA       cta          [FILL]s    [FILL: 1つのアクション + 1つのURL]      [FILL]
  (ウォークスルーの場合、機能ごとにリビール+証明を繰り返す)

合計:      [FILL]s   (JSONのcomposition.durationInFrames / fpsと一致する必要があります)
引き渡し:  scene-plan.json -> remotion-compose

references/why-the-first-3-seconds

視聴者は最初の約3秒で視聴を続けるかどうかを決定するため、フックはロゴやスローフェードを配置する場所ではありません。見返り(ペイオフ)や緊張感で始めてください。出荷されてしまったバグ、減少した数字、スクロールを止める主張。ロゴは隅に常に表示しても構いませんが、それを冒頭のビートにすることは、最も価値のある秒数を最も説得力の低いコンテンツに費やすことになります。1つのビートだけを確実に決めるなら、これ(フック)を決めてください。

references/pacing-by-scene-type

異なるシーンは異なる表示時間を必要とし、毎秒N秒の一律カットはスライドショーのように見えます。

  • タイトル/フック - 高速。1行、スナッピーな入り口、古くなる前にカット。
  • テキスト - 読む時間を与える。人々は約2.5ワード/秒で読みます。7ワードの行には約3秒、12ワードの行には約5秒が必要です。テキストの時間が不足することは、最も…

※元のMarkdownが途中で切れていますが、そのまま翻訳しています。

Individual skills in this repo

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

関連スキル