Communitygithub.com

フィルム・ナレーション作成

製品フィルムのピクチャー承認後に、実フレームを使ったストーリーボード上でナレーションを執筆、レビュー、テスト、録音します。Fish AudioでのTTS録音、フレーズ配置、ミックス・マキシングを行い、製品フィルム制作のステージ5です。AI音声っぽさやフレームとの不一致、製品名の誤発音がある場合に使用します。

フィルム・ナレーション作成 とは?

このスキルは、製品プロモーションフィルムのピクチャーが承認された後に、ナレーション(ボイスオーバー)を作成するためのワークフロー全体をカバーします。ピクチャーを基準にナレーションを合わせる原則に従い、まず各ショットの意図を理解し、複数のトーンや情報提供方法を持つ方向性(ディレクション)を考案します。各方向性を実際のフレームとともにストーリーボードに展開し、目を閉じて聞く一貫性チェック、フレームとの一致確認、第三者テストなど5つの自己検証を行います。次に、製品名の発音テストを実施し、発音ガイドをTS設定ファイルやスクリプトに記録します。その後、Fish Audioを使用してセクションごとにTTS録音を行い、各フレーズをフィルムのタイムラインに配置して重なりがないことを確認し、LUFS -14、-1 dBTP以下の基準でミックス、マキシングして出力します。ピクチャーが変更された場合も、プローブ、再配置、リミックスが可能です。Claude Code、Cursor、Codexなど、ファイル操作やスクリプト実行が可能なAIエージェントプラットフォーム上で動作します。

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

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

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

ドキュメント

フィルム・ナレーション作成 は何をしますか?

ナレーションはピクチャー承認後に作成し、ピクチャーに合わせる。ピクチャーがナレーションに合わせて動くことはなく、所有者が要請した場合を除く。書き始める前に references/writing.md(拒否されたパターンとその前後)をすべて読み、すべての草稿にコピーライティングスキルとヒューマナイザースキルを使用すること。

ゲート1:方向性とスクリプト(録音なし)

  1. 各ショットを理解する。 storyboard.json の各ビートについて、そのショットが何のためにあるかを一行で書く。わからなければ所有者に質問する。ショットが何を示しているように見えたか(小さなアイテムが並んだ壁の上のペット)を書いた行は却下された。
  2. 方向性(ディレクション)。 アングルが決まっている場合、視聴者に与える内容が異なる2~4の完全な方向性を書く。例:視聴者が使えるヒント · 日常の悩み · 仕組み · 疑問解消(主要な安全性、コスト、プラットフォーム)。各方向性について:完全なトランスクリプト、得意な点、リスク。自分の選んだものを最初に置く。
  3. ストーリーボードに実フレームで配置する。 ビートごとに静止画をレンダリングし(node scripts/render.mjs --at …)、方向性ごとに storyboard.json に vo を設定し、review/storyboard.html(film-storyboardのスクリプト)をビルドする。ページは各方向性がひとつの段落として開く:目を閉じて読むためのもの。
  4. 自己チェック。 references/writing.md の5つのテスト(目を閉じて、フレーム、他人、スロップスキャン、主張)を実施する。
  5. ストーリーボードを送り、どの方向性が良いか、何を変更すべきか尋ねる。product-film/references/question-bank.md からナレーションに関する質問(声、話しかける相手、トーン、ナレーション量)をする。明確な承諾が得られるまで反復する。承認されたスクリプトを VO-SCRIPT.md に行ごとの時間範囲と「各主張の出典」を付けて書き込む。コミットする。

ゲート2:発音(フル録音の前)

  1. 製品名(およびその他の特殊な語)の読み方を所有者の言葉で尋ねる(「ウィズゲット、gは硬く」のように)。
  2. スペルをテストする。 各スペルについて短いクリップひとつずつ(名前を含む短い文):プレーンな名前、ハイフン区切り、子音重複(例:「ニムベット」、「ニム-ベット」、「ニムベット」)。複数のスペルを一度に読ませると短くて混乱したものになる。ファイル名はスペルごとにつける。所有者に送り、選んでもらう。
  3. 勝者を vo.json › voice.note、VO-SCRIPT.md、および今後のフィルムのために記憶に記録する。エンジンが正しいスペルを誤って発音する場合、正しいスペルをエンジンに送ってはならず、代わりに再スペルをすべての場所で送信する。

ゲート3:録音、配置、ミックス

  1. まずクレジットを確認する: TTS残高を確認する。Fish Audio:1回の呼び出しあたり最大約500バイト、バイト単位で課金。セクションごとに録音(audio/vo/l1.wav、l2.wav…)、全スクリプトを1回の呼び出しで録音しない。
  2. 声: 所有者がサンプルから選んだ声(Fishの「Ethan」は落ち着いた製品フィルムで承認済み)。テンポはフレーズごとに tempo ≤ 1.1~1.15で調整し、テイク全体をスピードアップしない。
  3. フレーズに区切る: python3 scripts/vo.py --scan でテイクごとの音声セグメントを一覧表示し、vo.json に take、from、to、text を持つフレーズを書き込む。
  4. 各フレーズの at(ビート = 動画の秒数 × 2)を、キーワードが対応する画像やオンスクリーン文字と合うように配置する。node tools/probe.mjs cuts と "window.UNWARP(<ストーリータイム>)" で動画の時間を取得する。重なりがなくなるまで python3 scripts/vo.py を実行し、フレーズ間に0.25秒以上の間隔を空ける。
  5. ミックスとマキシング: python3 scripts/sfx_samples.py && python3 scripts/mix.py(-14 LUFS、≤ -1 dBTP;音声0、効果音約-10、BGMは所有者の選択による)、その後 node scripts/render.mjs --mux [--fmt 9x16]。
  6. ナレーション入りカットをトランスクリプトと各行の配置場所の表とともに送る。「聞こえません」と伝え、発音、ペース、レベル、間違ったフレームに乗っている行について尋ねる。反復する。vo.json と VO-SCRIPT.md をコミットする。

後でピクチャーが変更された場合

再プローブ、フレーズの再配置(at)、リミックス、リマキシングを行う。9:16の場合、タイミングが共通なら同じ audio/mix.wav が使える。

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-storyboard

Write the story of a product film as beats (what the viewer sees, the words on screen, the voice, the sound, why the beat exists, and where each claim is proven) and send it to the owner as a one-page storyboard with frames for review, with 2–4 directions when the story is open. Stage 2 of product-film, and the review format reused for the voiceover. Use when planning a launch/promo film's story, shot list, or script, or when the owner says "give me a storyboard", "give me directions", "I'll review and decide".

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

関連スキル