Communitygithub.com

フィルムストーリーボード

製品フィルムのストーリーをビート(視聴者が見るもの、画面上のテキスト、声、音、ビートの存在理由、各主張の証明箇所)として書き、レビュー用にフレーム付きの1ページストーリーボードとしてオーナーに送信します。ストーリーが未確定な場合は2~4の方向性を提示します。製品フィルム作成のステージ2であり、ナレーションにも同じレビューフォーマットを使用します。ローンチ・プロモーションフィルムのストーリー、ショットリスト、脚本の計画時、またはオーナーが「ストーリーボードをくれ」「方向性を示してくれ」「確認して決める」と言った場合に使用します。

フィルムストーリーボード とは?

このスキルは、製品フィルムのストーリーボードを作成するための専門的なツールです。ビート(視覚要素、オンスクリーンテキスト、ナレーション、効果音、各ビートの目的と主張の裏付け)を構造化し、オーナーがレビューできる1ページのHTMLストーリーボードを生成します。アングルが未確定な場合、2~4の異なる方向性を提示します。Claude Code上で動作し、`storyboard.json`ファイルを編集してからPythonスクリプトでHTMLをビルドします。良いストーリーには、視聴者の具体的な痛点、誤解されない役割表現、抽象表現でない具体性、多様なユーザー範囲、実際に存在する機能のみの使用、各ショットの目的明確化、読みやすいオンスクリーンテキスト、アクションで締めくくることなど、8つの品質基準があります。このスキルは、ビルド前の修正コスト削減(文章変更は1分、レンダリングショット変更は1時間)と、効率的なレビューサイクルを実現します。承認後は`storyboard.json`が唯一の真実の情報源となり、後の変更もここから反映します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aqeelshamz/product-film-skills/tree/HEAD/film-storyboard

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

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

ドキュメント

フィルムストーリーボード は何をしますか?

ストーリーボードは、オーナーの修正が最も集中的に行われるべき場所です。なぜなら、文章の変更は1分で済むのに対し、レンダリングされたショットの変更は1時間かかるからです。ビルドする前に送信し、録音する前に(実フレームとともに)再度送信してください。

優れた製品フィルムのストーリーとは

各ビートをこれらに照らしてチェックしてください。これらはすべて却下されたドラフトから生まれたものです(product-film/references/lessons.md 参照)。

  1. 視聴者の痛点を、彼らの日常の言葉で。 習慣や悩みを、視聴者自身が言うであろう方法で名付けてください。そのセリフをテストしてみてください:それを聞いた後、第三者は私たちが何を売っていると思うでしょうか?「毎日同じ数字」は人々に分析ソフトウェアを連想させたため、失敗しました。
  2. 役割を誤解させない。 実際のツールを名前とロゴで表示してください。隣接するセリフのペアをすべてチェックしてください:「すでに支払っているAIに聞いてください。それはNimbetと呼ばれています。」は製品がAIのように聞こえます。製品が何をするのかに名前を付けてください。
  3. 具体的に、抽象的にしない。 ラベルとしての「あなたのAI」は不明瞭でした。Claude Desktopの実際のウィンドウは明確でした。実際のStripeダッシュボードは「収益」と書かれたボックスよりも優れています。
  4. 範囲には余裕が必要。 約束が「あなたが必要とするものすべて」である場合、8種類以上の人物(各フルスクリーンカード)を表示し、その後、仕事、生活、娯楽(ゲーム、ペット、ステッカー)を混在させた多くのアイテムの壁を表示してください。6未満では「詰まった感じ」になります。これには45〜65秒必要で、20秒では短すぎます。
  5. 実際のものだけ。 すべてのアイテム、機能、主張は現在の製品で動作するものにしてください。claim フィールドに、それが証明される場所(ファイル、ドキュメント、テスト)を記入してください。ストーリーに製品ができないことが必要な場合は、オーナーに提起してください:構築するか、削除するかです。
  6. 各ショットを書く前に理解する。 すべてのビートに why を書いてください。ショットの目的が言えない場合は、オーナーに尋ねてください。(ペットのセリフが、実際には人々の独自のカスタムウィジェットを表示するショットに書かれていました。)
  7. すべての行が読めること。 オンスクリーンテキスト:1単語あたり約0.3秒+1秒、完全に表示されている時間が1.5秒を下回らないようにしてください。
  8. アクションで締めくくる。 名前とURL、およびブランドが表示された場合はその主格的使用法の行で終わらせてください。

手順

  1. 読む:承認されたブリーフ、reference/NOTES.md、実際の製品とサイト、そして教訓ファイルを読んでください。
  2. ビートをドラフト storyboard.json に作成します(フォーマットはスクリプトのヘッダー内):
    { "title": "…", "subtitle": "draft 1 · 16:9 · 60 s", "directions": ["A · …", "B · …"],
      "beats": [{ "t": "0.0–4.0", "still": "review/sketches/01.png", "picture": "…", "onscreen": "…",
                  "vo": {"A · …": "…", "B · …": "…"}, "sfx": "…", "why": "…", "claim": "…" }] }
    
    フィルムが存在する前は、still は簡単なスケッチか、注釈付きの参考フレームでも構いません。その後は、常に実際のレンダリングフレーム(node scripts/render.mjs --at …)を使用してください。
  3. 方向性。 アングルが未確定の場合、アイデアが異なり、表現が異なるだけではない2〜4の方向性を書いてください(例:「視聴者が使えるヒント」「日常の悩み」「あなたのAIがすでに知っていること」)。それぞれについて:一行のアイデア、リスク、適している対象。あなたの推奨を最初に置いてください。
  4. ページをビルド:
    python3 ~/.claude/skills/film-storyboard/scripts/storyboard.py storyboard.json review/storyboard.html
    
    各方向性のナレーションが1つの段落(目を閉じて読む用)として表示され、その後、各ビートとそのフレームが表示されます。
  5. 送信前に自己チェック: トランスクリプトの段落だけを読んでください。目を閉じても意味が通りますか?誤解される可能性のある行はありませんか?「あなたのX、あなたのY」リスト、三つ組、繰り返し単語はありませんか?証拠のない主張はありませんか?
  6. レビューゲート。 ページを送信し(SendUserFile、display render)、どの方向性か、どのビートを変更するかを尋ねてください。product-film/references/question-bank.md からステージ2の質問(オープニング、役割の表示方法、ペルソナ形式、キャラクター、UIのリアリズム)を追加してください。明確な了承を待ってください。storyboard.json をコミットしてください。

承認後

storyboard.json を唯一の真実の情報源として維持してください:フィルム内のショットタイミングとナレーション内のフレーズ配置は、すべてこれから取得されます。オーナーが後でビートを変更した場合、まずここで変更し、ページを再生成してください。

Individual skills in this repo

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

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

film-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

product-film

Make a product launch / promo / explainer film that sells and does not look or sound AI-made, through review gates the owner signs off one at a time. Study a reference video for its grammar (never copy it), then storyboard, build the film in code, add sound, write and record the voiceover, and deliver 16:9 and 9:16. Use when someone wants a launch video, promo, product film, explainer, ad, "a video like this one" for their product, or says the last video looked like "AI slop" or "vibe coded". Entry point for the film-* skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover).

関連スキル