Communitygithub.com

リールスクリプティング

参照リールを分析し、ニュースレターのトピックを基に、あなたの声に合った最適化済みリール台本を作成します。

リールスクリプティング とは?

このスキルは、人気のInstagramリールを逆分析し、そのフォーマットを学習してあなた自身のリール台本を作成するための包括的なツールです。Apifyを使ってInstagramからリールをスクレイピングし、Gemini 2.5 Flashで動画を解析し、あなたのニュースレターのトピックとボイスガイドライン(voice.md, about-me.md)に基づいて最適化された台本を生成します。フック、本文構成、CTAなどを95/100の品質ゲートで厳格にチェックし、一貫性のある高品質な台本を提供します。CodexやClaudeなどのAIエージェント上で動作し、手動のAPIキー設定とNode.js環境が必要ですが、動画ファイルの直接アップロードなど代替手段にも対応しています。

対応✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/charlie947/social-media-skills/tree/main/skills/reels-scripting

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

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

ドキュメント

リールスクリプティング は何をしますか?

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. リールをスクレイピングしてダウンロード

選択したプロジェクト内に新しい outputs/reels/<slug>/ フォルダを使用します。既存の適切なヘルパーがあればそれを再利用し、そうでなければそこに小さなタスク固有のNode.jsスクリプトを記述します:

  1. apify-client と既存の apify/instagram-reel-scraper ルートを使用します。その前に、現在のドキュメント化されたスキーマを確認し、単一の要求されたリールに対して使用します。コメント、返信、コメントスレッド(deepScrape や numComments を含む)は決してスクレイピングしないでください。呼び出す前に、プロバイダーが投稿/動画のみの収集をサポートしていることを確認し、そうでなければ動画のアップロードをリクエストします。別のアクター入力を推測しないでください。
  2. 返されたアイテムから videoUrl を抽出します。
  3. 動画を outputs/reels/<slug>/downloads/{username}_{shortCode}.mp4 にダウンロードします。
  4. 生のスクレイプデータを outputs/reels/<slug>/reel_data_{shortCode}.json に保存します。

スクリプトを実行します。続行する前に、ファイルサイズとメタデータ(閲覧数、いいね数、利用可能な場合は総コメント数、キャプションの最初の200文字)を確認します。

単一のリールは参照であり、検証された例外的なものではありません。比較データが提供されるか、明示的に要求された場合にのみ、それを例外的なものと呼びます。その場合、データは同じクリエイターの最近の投稿に対するパフォーマンスを確立し、サンプル、期間、複数の指標を引用します。そのベースラインを捏造しないでください。

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

Nodeスクリプトを拡張するか(または2回目のパスを実行)、以下を行います:

  1. ダウンロードした .mp4 をbase64として読み取ります。
  2. genAI.getGenerativeModel({ model: 'gemini-2.5-flash' }) を呼び出します。
  3. 動画を以下のプロンプトとともに送信します:
私はこのリールを研究して、自分のオーディエンス [about-me.md の AUDIENCE] 向けに同様のスタイルで自分の台本を書いています。

## 完全なトランスクリプト
- すべての単語をタイムスタンプ付きで書き起こす

## フック
- 最初に話された正確な単語
- フックの単語数
- スクロールを止めるものは何か?

## 言語パターン
- 平均文長
- you/your 対 I/me の比率
- ポイント間の遷移
- 「ちょっと」のような最小化語はどこにあるか?

## 構造
- 合計時間
- タイミング付きのセクション内訳
- ビフォー/アフターの瞬間は何か?
- CTAは何か?

## 1つの重要な洞察
- このリールから学ぶべき、最も重要な単一のテクニック

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

ステップ 5. 新しいリール台本を書く

ステップ4の分析、ステップ2のニュースレタートピック、およびユーザーのボイスファイルを使用して、新しいリール台本を outputs/reels/<slug>/reel-[slug].md に書き込みます。

以下のルールを適用します(譲歩不可):

フック

  • 決して「私は」で始めない。「これ」、「あなた」、事実、または名前を使用します。
  • 実証済みのフォーマット: 「これは...を永遠に変えた」/ ネガティブフリップ (「Xは役に立たない...」) / 能力の表明。
  • フックは3秒以内に好奇心を生み出すか、パターンを中断します。
  • 参照分析から、フックの単語数と構造をミラーリングします。

本文

  • イギリス英語。短い文。ダッシュなし、セミコロンなし。
  • 「あなた」と「ちょっと」を会話的に使用します(「あなたはちょっとドロップインする...」)。
  • 3つ以上のスタッカートフラグメントを決して結合しないでください。1つの流れるような文に結合します。
  • 結論を述べないでください。事実に任せてください。
  • ユーザーが実際の成果物と確認済みの動作する自動化を持っている場合のみ、コメントCTAを使用します。それ以外の場合は、配信を約束しない関連する次のアクションを使用します。

コメントトリガー(サポートされている場合のみ)

  • 大文字の単一単語のみ(SCRIPT、WIKI、PROMPTS、VIDEO)。
  • 約束されている内容に直接関連している必要があります。
  • 引用符なし、「以下」なし、末尾の句読点なし。

CTA

  • 「[WORD]とコメントしてください。そうすれば[具体的なもの]をお送りします」
  • 短く。「私の完全な...へのリンク」のようなパディングはありません。

時間と構造

  • 合計30〜45秒を目標にします。
  • 最大2つのポイント。3つではありません。
  • キャプションは台本をミラーリングします。両方を一緒に更新します。

台本ファイルの構造

# リール: [タイトル]

## 参照分析
- URL: [リールURL]
- 閲覧数: [数値]
- 主要テクニック: [Gemini分析から]

## 目標時間
30〜45秒

## フック (0-3秒)
[正確な単語]

## ポイント1 ([開始]-[終了]秒)
[正確な単語]

## ポイント2 ([開始]-[終了]秒)
[正確な単語]

## CTA ([開始]-[終了]秒)
[次のアクション。配信が確認されている場合のみコメントの約束を含める]

---

## キャプション
[台本をミラーリングし、Instagram向けにフォーマット]

## コメントトリガー(設定されている場合のみ)
[WORD または 該当なし]

## 成果物(約束されている場合のみ)
[実際に利用可能なリソース または 該当なし]

---

## ビジュアルノート
[カット、Bロールのアイデア、テキストオーバーレイ]

ステップ 6. QAループ

実行中のアシスタントでレビューします: ソースの正確性 (30)、ユーザーの声 (25)、フックと構造 (20)、話された時間と明瞭さ (15)、キャプション/CTAの一貫性 (10)。各スコアの根拠を引用します。実際の違反を修正し、最大3回まで再スコアリングします。合格ラインは95/100です。解決できない場合は、スコアを水増ししたり、準備完了と主張したりせず、具体的なブロッカーとともにドラフトを報告します。可能な場合は音読時間を計測し、そうでない場合は時間は推定とラベル付けします。CodexでのこのレビューにClaudeは必要ありません。

確認すべき一般的な違反:

  • 「私は」で始まる
  • 3つ以上のスタッカートフラグメント
  • 結論を述べている
  • 複数単語または装飾されたコメントトリガー
  • 音読したときに45秒を超える
  • 2つではなく3つのポイント
  • キャプションが台本をミラーリングしていない

ステップ 7. 台本を引き渡す

レビュー済みの台本とそれに対応するキャプションをプロジェクト内に納品し、参照ソース、分析方法、および未解決のチェック事項を添えます。ユーザーはそれを録音するか、自身の利用可能な制作ワークフローを明示的にリクエストできます。この公開スキルは、アバター、編集、公開パイプラインを提供しません。

ルール

  • 95/100のQAゲートを決してスキップしないでください。
  • 台本を書く前に常に voice.md と about-me.md を読んでください。声の一致は譲歩できません。
  • 参照リールからのメトリクスを決して捏造しないでください。検証済みの提供または取得されたメタデータのみを使用し、不足しているメトリクスは利用不可とマークします。
  • イギリス英語。ダッシュなし。セミコロンなし。
  • すべての台本には対応するキャプションを含めます。約束された配信が機能する場合のみ、コメントトリガーを含めます。
  • 参照へのアクセスが失敗した場合は、失敗したステージを報告し、提供された動画/トランスクリプト入力を提供します。動画分析を捏造しないでください。
  • Gemini 2.5 Flash がモデルです。ユーザーの承認なしに代替しないでください。

Individual skills in this repo

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

関連スキル