reels-scripting

リールの台本作成

Codex と Claude のランタイム

• このスキルは、Codex または Claude で、現在のタスクで実際に利用できるツールを使ってください。AskUserQuestion の例は質問内容を示すものであり、必須の API ではありません。利用可能な質問ツールをその制限内で使うか、チャットで質問してください。すでに提供された回答や資料は再利用してください。
• ユーザーが選択したプロジェクトで作業してください。個人向けの作業を始める前に、そのプロジェクトの about-me.md、voice.md、関連するブランドファイルを読んでください。ファイル間で内容が矛盾している場合や、初期設定の内容が含まれている場合は、想定される作成者を確認してください。不足している情報を尋ねるか、voice-builder を実行してください。メンテナーの身元、アカウント、プライベートファイルを決して引き継がないでください。
• バンドルされている references/ は、このスキルのフォルダーを基準に参照してください。プロフィールの更新が明示的に依頼された場合は、正規の about-me.md、voice.md、または newsletter-voice.md をその場で読み込み、更新してください。その際、関係のないユーザー情報やルールは保持してください。利用側は、これらの正規ファイルを再度読み込む必要があります。既存の無関係なファイルと名前が重複する新しい成果物を作る場合に限り、新しいファイル名を使ってください。インストールだけでインタビューを開始したり、ファイルを書き込んだりしてはいけません。依頼がない限り、永続的な学習内容を書き込まないでください。
• 提供された根拠を優先して使ってください。必要な場合は、利用可能な検索ツールやソースツールで外部の主張を検証してください。ソースや連携機能が利用できない場合は、不足している機能を伝え、提供されたテキストやエクスポートデータを入力として使う方法を提示してください。事実、一人称の経験、指標、ツールの実行成功を捏造してはいけません。
• 選択した方法に必要なサービスだけを、ユーザーが既存のアカウントを通じて接続してください。認証情報を表示したり、接続を上書きしたりしてはいけません。下書きの作成、保存、レビューは、公開、メッセージの送信、アカウントの変更を許可するものではありません。

重要：読み込み時に自動開始

このスキルが呼び出されたら、要約せず、すぐにステップ 1 に進んでください。

前提条件

Apify と Gemini を使った完全な動画分析ルートには、次のものが必要です。

• APIFY_API_TOKEN 環境変数（Instagram のスクレイピング用）
• GOOGLE_AI_API_KEY 環境変数（Gemini 2.5 Flash による動画分析用）
• Node.js 18+ と apify-client および @google/generative-ai パッケージ

選択した方法に必要な機能だけを確認してください。URL の抽出と Gemini による動画分析を行う場合は、ユーザーの既存の認証情報が設定されていることを、値を表示せずに確認してから、プロバイダーとモデルが利用可能か確認してください。認証情報やパッケージが不足している場合、動画が非公開の場合、またはモデルを利用できない場合は、その段階を保留にしてください。不足しているものを説明してください。アカウント設定を変更したり、ユーザーに知らせずにプロバイダーを代替したりしてはいけません。

動画が提供されている場合は、Apify を省略できます。文字起こしや分析結果が提供されている場合は、ステップ 3 と 4 を省略し、ステップ 5 で文字起こしに基づくことを明記した台本を作成できます。ただし、それは Gemini による動画分析の結果ではありません。ヘルパースクリプトを生成する前に、インストール済みのパッケージを再利用し、公式 SDK とアクターの最新ドキュメントを確認してください。また、プロバイダーの利用料金が発生する前に、ユーザーの承認を得てください。

ステップ 1. 参考資料を入手する

次のように尋ねてください。

参考にするリールの URL または Notion のリンクを貼り付けてください。これは、形式をリバースエンジニアリングするための、特に優れたリールです。

URL が届くまで待ちます。

ユーザーが Notion のリンクを貼り付けた場合は、利用可能な認証済み Notion コネクターを通じて内容を読み込み、ページ内の Instagram リール URL を見つけて抽出してください。Notion ページにリール URL が見つからない場合は、リールの URL を直接貼り付けるようユーザーに依頼してください。

ステップ 2. ニュースレターのトピックを入手する

次のように尋ねてください。

このリールに再利用したいニュースレターのトピックは何ですか？該当するニュースレターのセクションを貼り付けるか、核となるアイデアを一文で入力してください。

トピックが届くまで待ちます。スクリプトがユーザーの文体に合うよう、プロジェクト内に newsletter-voice.md、voice.md、about-me.md があれば読み込んでください。

ステップ 3. Reel をスクレイピングしてダウンロードする

選択したプロジェクトに、新しい outputs/reels/<slug>/ フォルダーを使用します。適切な既存ヘルパーがあれば再利用し、なければ、そこでタスク専用の小さな Node.js スクリプトを作成して、次の処理を行います。

1. 現在のドキュメントに記載されたスキーマを確認したうえで、apify-client と既存の apify/instagram-reel-scraper ルートを使い、指定された 1 つの Reel を対象にします。コメント、返信、コメントスレッドは、deepScrape や numComments を介する場合も含め、一切スクレイピングしないでください。呼び出す前に、プロバイダーが投稿／動画のみの収集に対応していることを確認してください。対応していない場合は、動画のアップロードを依頼してください。代替の Actor 入力を推測しないでください。
2. 返されたアイテムから videoUrl を抽出します。
3. 動画を outputs/reels/<slug>/downloads/{username}_{shortCode}.mp4 にダウンロードします。
4. スクレイピングした生データを outputs/reels/<slug>/reel_data_{shortCode}.json に保存します。

スクリプトを実行します。続行する前に、ファイルサイズとメタデータ（再生数、いいね数、取得可能な場合はコメントの合計数、キャプションの先頭 200 文字）を確認します。

単一の Reel は参考例であり、外れ値であることが確認されたものではありません。同じクリエイターの最近の投稿と比較して好成績であることを、提供された、または明示的に依頼された比較データが示す場合に限り、外れ値と呼んでください。サンプル、期間、倍率を明記します。基準値を捏造しないでください。

ステップ 4. Gemini 2.5 Flash で分析する

Node スクリプトを拡張する（または 2 回目の処理を実行する）ことで、次の処理を行います。

1. ダウンロードした .mp4 を base64 として読み込みます。
2. genAI.getGenerativeModel({ model: 'gemini-2.5-flash' }) を呼び出します。
3. 動画を、次の正確なプロンプトとともに送信します。

I'm studying this Reel to write my own script in a similar style for my audience of [AUDIENCE FROM about-me.md].

## Full Transcript
- Transcribe EVERY word with timestamps

## Hook
- Exact first words spoken
- Word count of the hook
- What makes it stop the scroll?

## Language Patterns
- Average sentence length
- You/your vs I/me ratio
- Transitions between points
- Where are the 'just' minimisers?

## Structure
- Total duration
- Section breakdown with timings
- What's the before/after moment?
- What's the CTA?

## One key insight
- The single most important technique to learn from this Reel

分析結果を outputs/reels/<slug>/analysis_reference_{shortCode}.md に保存します。

ステップ 5. 新しい Reel の台本を作成する

ステップ 4 の分析、ステップ 2 のニュースレターのトピック、ユーザーのボイスファイルを使って、新しい Reel の台本を outputs/reels/<slug>/reel-[slug].md に作成します。

次のルールを適用します（必須）。

フック

• 「I」で始めないでください。「this」「you」、事実、または名前を出す表現を使います。
• 実績のある形式：「This changed... forever」／否定的なひねり（「X is useless unless...」）／能力の表明。
• フックは 3 秒以内に好奇心をかき立てるか、意表を突くものにします。
• 参考分析のフックと、語数および構成を合わせます。

本文

• イギリス英語を使います。短い文にします。ダッシュやセミコロンは使いません。
• 「you」と「just」を会話のように使います（「you just drop in...」）。
• 3 つ以上の断片的な文をつなげないでください。流れるような 1 文にまとめます。
• 結論を明言しないでください。事実に語らせます。
• ユーザーが実際に提供できるものを持ち、動作確認済みの自動化がある場合に限り、コメントを促す CTA を使います。それ以外の場合は、何かを届けると約束せず、関連する次のアクションを促します。

コメントのトリガー（対応できる場合のみ）

• 大文字 1 語のみ（SCRIPT、WIKI、PROMPTS、VIDEO）。
• 約束する内容に直接関連している必要があります。
• 引用符、「below」、末尾の句読点は使いません。

CTA

• 「Comment [WORD] and I'll send you [具体的なもの]」
• 短くします。「the link to my full」のような余分な表現は使いません。

長さと構成

• 全体で 30～45 秒を目指します。
• 重要なポイントは最大 2 つです。3 つにしないでください。
• キャプションは台本に合わせます。両方を同時に更新します。

台本ファイルの構成

# Reel: [title]

## Reference analysis
- URL: [reel url]
- Views: [number]
- Key technique: [from Gemini analysis]

## Duration target
30-45 seconds

## Hook (0-3s)
[Exact words]

## Point 1 ([start]-[end]s)
[Exact words]

## Point 2 ([start]-[end]s)
[Exact words]

## CTA ([start]-[end]s)
[Exact next action, with a comment promise only when delivery is confirmed]

---

## Caption
[Mirror the script, formatted for Instagram]

## Comment trigger (only if configured)
[WORD or not applicable]

## Deliverable (only if promised)
[The real available resource or not applicable]

---

## Visual notes
[Cuts, B-roll ideas, text overlays]

ステップ 6. QA の反復

実行中のアシスタントでレビューします。正確性（30 点）、ユーザーの声の再現（25 点）、フックと構成（20 点）、読み上げ時間と明瞭さ（15 点）、キャプションと CTA の一貫性（10 点）を評価します。各評価の根拠を示します。実際の違反を修正して再評価し、最大 3 回まで行います。合格基準は 95/100 です。解決できない場合は、評価を水増ししたり準備完了と主張したりせず、具体的な障害事項を添えてドラフトとして報告します。可能な場合は実際に読み上げて時間を計ります。そうでない場合は、所要時間を推定と明記します。Codex でのこのレビューに Claude は必要ありません。

よくある違反を確認します。

• 「I」で始まっている
• 断片的な文が 3 つ以上ある
• 結論を明言している
• コメントのトリガーが複数語、または装飾されている
• 声に出して読むと 45 秒を超える
• ポイントが 2 つではなく 3 つある
• キャプションが台本に合っていない

ステップ 7. スクリプトを引き渡す

レビュー済みのスクリプトと対応するキャプションを、参照元、分析方法、未解決の確認事項とともにプロジェクト内に納品します。ユーザーは自身で収録することも、利用可能な制作ワークフローを明示的に依頼することもできます。この公開スキルには、アバター、編集、公開のパイプラインは含まれていません。

ルール

• 95/100 の QA ゲートを絶対に省略しないでください。
• 執筆前に必ず voice.md と about-me.md を読んでください。声の一致は譲れません。
• 参照 Reel の指標を決して捏造しないでください。検証済みの、提供または取得したメタデータのみを使用し、存在しない指標は利用不可と明記してください。
• イギリス英語を使用してください。em dash とセミコロンは使用しないでください。
• すべてのスクリプトに対応するキャプションを含めてください。約束した配信が機能する場合に限り、コメントのトリガーを含めてください。
• 参照元にアクセスできない場合は、失敗した段階を報告し、提供された動画または文字起こしの入力を提案してください。動画分析を捏造しないでください。
• モデルは Gemini 2.5 Flash です。ユーザーの承認なしに変更しないでください。