Community画像github.com

mrvijaykr56/youtubeshorts

生のアイデア、トピック、記事、ラフドラフトを、滞留率の高いバイラルYouTubeショートのストーリーボードに変換する専門エージェントスキル。厳密なJSON形式で、0-3秒の心理的フック、インパクトのあるナレーション、埋め込み字幕絵文字、9:16画像生成のための詳細なビジュアルカメラプロンプトを出力します。英語、ヒンディー語、ヒングリッシュに対応。

youtubeshorts とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)向けに設計された、YouTubeショート動画の台本作成とストーリーボードディレクションを専門に行うツールです。ユーザーが提供するアイデアや記事を、視聴者の滞留率を最大化するバイラル動画の設計図に変換します。具体的には、0-3秒で視聴者を惹きつける「フック」、短いながらも印象に残るナレーション(英語/ヒンディー語/ヒングリッシュ対応)、視覚的な魅力を高める字幕用絵文字、そしてAI画像生成ツール(例:Midjourney、DALL-E)向けの詳細なカメラアングルやライティング指示を含むプロンプトを、厳格なJSONフォーマットで生成します。このスキルの核心は、心理学とプラットフォームのアルゴリズムに基づいたルール群にあります。3秒ルール、シーンあたりの厳密な単語数制限、適切な絵文字の挿入、そしてキャラクターと世界観を一貫させるための「Character DNA Anchor」や「World Anchor」といった独自のフレームワークを採用し、AIが生成するビジュアルの質と一貫性を保証します。複数のストーリーボードフォーマット(キャラクター駆動型、バイラルファクト型、対話型、教育チュートリアル型)をサポートし、出力前に組み込みのバリデーターで台本の品質をチェックします。最終的な画像生成はユーザー承認後に行うことで、トークンとリソースの無駄を防ぎます。

対応~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/mrvijaykr56/youtubeshorts/tree/HEAD/.agents/skills/shorts-script-polisher

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

ドキュメント

YouTubeショート台本ポリッシャー & ストーリーボードディレクター

このスキルは、エージェントがバイラル性が高く滞留率の高いYouTubeショート向けの台本を作成し、YTShortsレンダリングパイプラインと互換性のある構造化ストーリーボードJSONに変換することを支援します。


1. YouTubeショート滞留率の核となる原則

  1. 3秒フックルール:

    • 最初のシーンは、好奇心のギャップ、逆説的な質問、直感に反する発言、またはハイステークスの暴露によって、スクロールを中断させなければなりません。
    • 悪い例: 「今日はハチミツとその特性について話します。」
    • バイラル例: 「ハチミツが決して腐らないって知ってた? 🍯 科学者たちがエジプトの墓から3000年前のハチミツを食べたんだ!」
  2. ペーシング、単語数 & シーンあたり2行ルール 📜:

    • シーン数: 5~6シーン。
    • シーンあたり2行の必須化: 1行だけのシーンは絶対に書かないでください。各シーンには2行の魅力的で説明的な文(1シーンあたり約18~22ワード)が必要です。
    • 目標尺: 合計95~110ワード(約45~52秒)。1行シーンは短すぎて(約25秒)不完全に感じられます。2行シーンにすることで、登場人物の深み、感覚的な詳細、感情的なプロットの解決を可能にしつつ、60秒のショート制限内に安全に収めることができます。
    • 1シーン = 2つのストーリーライン = 1つの統一されたビジュアルイメージ(ダイナミックなケンモーショントランジションで8~10秒保持)。
  3. 字幕絵文字の注入:

    • 各シーンのナレーションに、文脈に適した絵文字を1~2個埋め込みます(例:🏛️、👑、⚡、💀)。
    • これらの絵文字は、キャプションスタイリングエンジン(TikTok/カラオケスタイル)によって視覚的なアクセントとして使用されます。
  4. 厳格な言語純度(完全英語または完全ヒンディー語のみ) 🎙️:

    • 話すナレーションは100%純粋な英語または100%純粋なヒンディー語でなければなりません。ヒンディー語のナレーション文に英単語やヒングリッシュを決して混ぜないでください。
    • 話す絵文字は禁止: 絵文字は視覚的な字幕表示専用です。TTSエンジンは自動的にオーディオストリームから絵文字を除去するため、音声モデルが絵文字名(例:「懇願する顔」、「キラキラ」)を読み上げることはありません。
  5. デフォルトキャプション基準 & バイリンガル設定 📺:

    • 位置: 常に下部中央(配置2、MarginV=240)に設定し、キャラクターの顔を隠すことなく、画面下3分の1にキャプションが安全に収まるようにします。
    • フォントサイズ: キャンバスをクリーンで読みやすく保つため、縮小されたコンパクトなフォントサイズ(ベース50px)を使用します。
    • バイリンガルショート(ヒンディー語音声 + 英語キャプション): narration_hi(100%純粋なヒンディー語で発話)とnarration(英語のキャプションで表示)の両方を常に含めます。
  6. 高CTRバイラルタイトルフォーミュラ 💥:

    • すべてのタイトルは、好奇心を刺激するヒンディー語のフック、英語の文脈説明サブタイトル、そしてランキングタグで構成します。 [感情的なヒンディー語フック + 絵文字] | [パンチの効いた英語サブタイトル] | [ニッチタグ #Shorts]
    • 例: लालिची बंदर को मिली जादुई सीख! 🐒✨ Never Be Greedy | Hindi Kahaniya #Shorts
    • 例: आसमान से गिरा एक जादुई तारा! 🐿️⭐ Cheeku's Magic Wish | Hindi Kids Story #Shorts
  7. シームレスループ & 完全な感動的なエンディング(100%以上のAPVを目標に) 🔄:

    • エンディングは、クリーンで文法的に完全で、感動的なものにします。
    • 🚫 「まるで...のように」 / 「ठीक जैसे...」の厳格な禁止: 「まるで...のように」、「まるで」、「जैसे...」、「ठीक जैसे...」のような比較の語幹でナレーションを決して終わらせないでください。すべての文は完全に解決され、パンチが効いていて、自己完結している必要があります。
    • 開始の例: 「क्या आप जानते हैं कि एक जादुई बत्तख पूरे गांव को कैसे बदल सकती है? 🪺✨」
    • 終了の例: 「हमेशा याद रखें, सब्र और संतोष ही जीवन का सबसे बड़ा खजाना है! 🌟」(完全で感動的な教訓)。
  8. オーディエンス & グロースメタデータペイロード 📈:

    • 常にストーリーボードJSONに以下を含めます:
      • story_moral: 親が共有しやすいように、ヒンディー語での感情的な教訓(शिक्षा)。
      • pinned_comment_question: コメント数を増やすための、考えさせられるヒンディー語の質問。
      • self_declared_made_for_kids: false(一般視聴者/家族向け。コメントと通知ベルを有効にするため)。
  9. トップ10競合SEOアーキテクチャ(Koo Koo TV、Infobells、PunToon Kidsをベンチマーク) 🏆:

    • 主要ハッシュタグ: 説明文の一番上に、速度の高いハッシュタグクラウドを配置します(例:#Shorts #HindiKahaniya #MoralStories #Panchatantra #KidsAnimation #3DAnimation #HindiCartoon #BalKahani)。
    • 3層タグクラウド(25~28タグ):
      • 第1層(ストーリー/キャラクター): 正確なキャラクター名、ストーリータイトル、英語 + 翻字ヒンディー語(例:sone ka anda、golden goose story、lalchi kisan)。
      • 第2層(高トラフィックニッチアンブレラ): jadui kahaniya、hindi animated tales、hindi stories for kids、hindi story cartoon、moral stories in hindi、panchatantra stories、stories for kids、bedtime stories in hindi。
      • 第3層(デーヴァナーガリー二重表記): हिंदी कहानियां、पंचतंत्र की कहानियां、नैतिक कहानियां、हिंदी कार्टून、बाल कहानियां。
    • カテゴリ: 常にカテゴリ1(映画とアニメーション) を適用します。

2. キャラクターDNA & 世界観一貫性フレームワーク 👥🌍

すべてのシーンのイメージが同じ映画に属しているように見せるために:

  1. キャラクターDNAアンカー: ストーリーにキャラクターが含まれる場合、5つの固定特性を持つ不変のキャラクターアンカーを定義します:

    • 名前 & 年齢/体格: 例:「マヤ、26歳の運動的な女性」
    • 髪 & 目: 例:「乱れたカーリーダークレイブンヘアをゆるいポニーテールに、鋭いヘーゼル色の目」
    • 特徴的な顔の特徴: 例:「鼻の周りのそばかす、決意に満ちた表情」
    • シグネチャー衣装: 例:「使い込まれたオリーブ色のリネンサファリシャツ、真鍮のコンパスネックレス、茶色のレザーベルト」
    • 裸の代名詞は絶対に使わない: 「彼女は遺物を見る」や「少女が走る」とは決して書きません。常に次のように書きます: 「マヤ(26歳、カーリーダークポニーテール、オリーブサファリシャツの女性)が金色の遺物を調べている...」
  2. 世界 & 環境アンカー: 設定、照明、パレットで不変のワールドアンカーを定義します:

    • 例: 「古代の地下砂岩の墓、ちらつく琥珀色の松明の灯り、深いコバルト色の影、浮遊する大気中の埃の粒子、35mmフィルムグレイン。」
    • すべてのシーンプロンプトはこのワールドアンカーを継承し、照明、色温度、建築が100%統一されたままになるようにしなければなりません。
  3. ショット進行 & 重複禁止ルール(冗長なビジュアル禁止) 🚫🔄:

    • プロンプトを決して繰り返さない: 連続するシーンは、同一のフレーミング、アクション、カメラアングルを絶対に共有してはなりません。
    • 動的なショット進行を適用する:
      • シーン1: 導入ワイド / 壮大なスケール(壮大な環境で視聴者をフック)
      • シーン2: ミディアムアクション / 発見(アクションを実行する被写体またはキャラクターに焦点を当てる)
      • シーン3: 超マクロクローズアップ(複雑なテクスチャ、光る詳細、または科学的なミクロビューを明らかにする)
      • シーン4: 肩越し / 高緊張アングル(クライマックス、反応、または暴露)
      • シーン5以降: ヒーローローアングル / 映画的なクライマックス(解決とCTA)

3. ストーリーボードの種類と形式

形式A: キャラクター駆動ストーリー / ナラティブ(アンカーあり)

{
  "character_anchor": "マヤ、26歳の女性考古学者、乱れたカーリーダークレイブンヘアをポニーテールに、オリーブリネンサファリシャツ、真鍮のコンパスネックレス",
  "world_anchor": "古代エジプトの地下砂岩の墓、ちらつく琥珀色の松明の灯り、深いコバルト色の影、浮遊する金色の埃の粒子",
  "scenes": [
    {
      "scene_number": 1,
      "narration": "エジプトの砂漠の奥深くで、マヤは3000年もの間封印されていた墓を発見した! 🏛️",
      "visual": "マヤ(26歳女性考古学者、カーリーダークポニーテール、オリーブリネンシャツ)が、ちらつく青銅の松明を掲げ、光るヒエログリフで覆われたそびえ立つ石の扉に畏敬の念を込めて見つめている、ローアングル映画的なショット、暖かい琥珀色の松明の灯り、ドラマチックなリムライティング、9:16垂直フレーミング、8k解像度"
    },
    {
      "scene_number": 2,
      "narration": "内部では、手つかずのアラバスターの壺が3つ、松明の灯りに照らされて輝いていた。 🍯",
      "visual": "マヤ(26歳女性考古学者、カーリーダークポニーテール、オリーブリネンシャツ)が古代の石の祭壇の横にひざまずき、3つの半透明の金色の蜂蜜の壺を調べている、マクロ超クローズアップ、暖かい琥珀色の輝きが彼女の顔を照らす、ボリューメトリックライティング、9:16垂直"
    }
  ]
}

形式B: バイラルファクト / ナラティブ(デフォルト)

標準的なストーリーテリングや驚くべき事実のショート。

[
  {
    "scene_number": 1,
    "narration": "あなたの脳が瞬きする前に未来を予測できたらどうなる? ⚡",
    "visual": "発光する人間の目の超クローズアップ、虹彩の中で電気的なシアンとマゼンタの稲妻が脈打つ神経シナプス、映画的なマクロ写真、浅い被写界深度、9:16垂直フレーミング、フォトリアリスティック8k、ドラマチックなリムライティング"
  },
  {
    "scene_number": 2,
    "narration": "科学者たちは、あなたの潜在意識があなたが気づく7秒前に決断を下していることを発見した! 🧠",
    "visual": "未来的な研究所のMRIスキャナーが、燃えるようなオレンジ色の神経経路を持つ光るホログラフィックの人間の脳を可視化している、暗くムーディーな美学、ボリューメトリックライティング、8k解像度"
  }
]

形式B: 2キャラクター対話ショート

2人のキャラクター間の交互の会話(インタビュー、討論、コメディに最適)。

[
  {
    "scene_number": 1,
    "speaker": "ホスト",
    "narration": "仮想不動産に5万ドル使ったの?! 🤯",
    "visual": "モダンなポッドキャストスタジオ、鮮やかなネオンパープルのバックライト、衝撃を受けてカメラを見つめる表情豊かな若いホスト、浅い被写界深度、映画的な照明"
  },
  {
    "scene_number": 2,
    "speaker": "ゲスト",
    "narration": "そして、それを昨日50万ドルで売ったんだ! 📈💰",
    "visual": "サンセットのスカイラインを見下ろすモダンなペントハウスオフィスで微笑む自信に満ちた若い起業家、暖かい映画的な照明"
  }
]

形式C: ステップバイステップ教育チュートリアル

タイトルと箇条書きを使ったスライドベースのチュートリアルに使用。

[
  {
    "scene_number": 1,
    "step_title": "はじめに",
    "slide_title": "Pythonリストをマスターする",
    "bullets": [
      "アイテムの順序付きコレクション",
      "角括弧 [] で定義",
      "完全にミュータブルで動的"
    ],
    "code_snippet": "fruits = ['apple', 'mango']",
    "narration": "30秒以内にPythonリストをマスターするための3つの必須テクニックをご紹介! 🐍",
    "visual": "洗練された3Dモダンな開発者ワークステーション、モニターに光るPythonコード、ミニマリストなダークモードスタジオ美学"
  }
]

3. AI画像生成のためのビジュアルプロンプトエンジニアリング

すべてのシーンの"visual"フィールドは、スタンドアロンで高忠実度のプロンプトとして設計されなければなりません:

  1. ショットタイプ & アングル: マクロ超クローズアップ、ローアングル英雄的ワイドショット、アイレベル映画的ポートレート、俯瞰的な雰囲気のあるビュー。
  2. 被写体 & アクション: 正確な物理オブジェクト、キャラクターのジェスチャー、表情。
  3. 照明 & 雰囲気: ボリューメトリックゴッドレイ、ドラマティックキアロスクーロ、ムーディーなサイバーネオンリムライティング、暖かいゴールデンアワーの輝き。
  4. 構図 & 品質: 9:16垂直フレーミング、被写界深度 / ボケ、フォトリアリスティック8k、カラーグレーディングされた映画的なフィルムスチル。
  5. ネガティブルール: 「クール」、「ナイス」、「画面上のテキスト」、「ウォーターマーク」、または一般的な非視覚用語を決して書かないでください。

4. プレフライトバリデーターチェック(ゼロトークン浪費保証) 🛡️

トークンの浪費、実行の中断、またはビデオレンダリングエラーを防ぐために、すべてのストーリーボードは、ユーザーへの受け渡しと画像生成の前に検証に合格する必要があります。

組み込みのバリデーターを直接実行できます:

.\backend\venv\Scripts\python.exe backend\scripts\storyboard_validator.py --json "path/to/script.json"

バリデータールールセット:

  1. シーン数: 4~9シーン(理想: 5~8シーン)。10シーンを超えるとブロックされます。
  2. ナレーション尺 & 制限: 総単語数は45~130ワード(約20秒~55秒)でなければなりません。130ワードを超えると、YouTubeの60秒ショート上限に違反するためブロックされます。
  3. シーンごとのペーシング: シーンあたり8~16ワード。キャプションの折り返しやモバイル画面のはみ出しを防ぎます。
  4. TTSフォーマット整合性: 発音不可能なマークダウンアーティファクト(**太字**、_斜体_、[SFXノート]、# ヘッダー)を削除し、TTSがリテラルなコードトークンを読み上げないようにします。
  5. 字幕絵文字: ダイナミックなTikTok/カラオケ字幕のために、1~2個の絵文字が注入されていることを確認します。
  6. ビジュアルプロンプトの安全性 & 精度:
    • 禁止トークンフィルター: text、letters、subtitles、words、watermark、font、logo などの単語をフラグします。これらはImagenに歪んだテキストアーティファクトをレンダリングさせる原因となります。
    • 構図シグナル: 明示的なカメラアングル(マクロクローズアップ、ワイドショット、映画的ポートレート など)を要求します。
    • 照明シグナル: 明示的な照明の手がかり(ボリューメトリックレイ、キアロスクーロ、ゴールデンアワー、松明の灯り など)を要求します。

5. 必須の人間による承認ゲートウェイ 🛑

重要なルール: ユーザーの明示的な承認なしに、自動的に画像を生成しないでください。

  1. ストーリーボードがプレフライトバリデーターにブロッキングエラー0で合格したら、クリーンなストーリーボードと検証レポートをユーザーに提示します。
  2. ユーザーに承認を求めます:

    「ストーリーボードはすべてのプレフライトチェックに合格しました(尺:約Xs、シーン数:N、トークン安全性:100%)。これらのシーンとビジュアルディレクションを承認しますか、それとも画像を生成する前に調整が必要ですか?」

  3. 画像生成ツールを呼び出す前に、ユーザーの確認を待ってください。

6. トップ10競合メタデータ & SEOアーキテクチャ 🏆

生成されるすべてのショートは、Koo Koo TV(488万登録者)、Infobells Hindi(7280万登録者)、PunToon Kids(394万登録者) から直接ベンチマークされた競合のメタデータを含まなければなりません:

1. タイトル作成(厳格に $\le 95$ 文字)

YouTubeは100文字以上のタイトルを拒否します。実績のある高CTRフォーミュラを使用してください: [ヒンディー語での感情的なフック / 興味をそそる質問 + 1~2個の絵文字] [英語名] | 3D Hindi Kahaniya #Shorts

  • 例: कुल्हाड़ी नदी में गिरी, जलपरी ने क्या दिया? 🪓✨ Honest Woodcutter | 3D Hindi Kahaniya #Shorts(92文字)
  • 例: रोज एक सोने का अंडा! पर लालच ने क्या किया? 🪺✨ Goose of Gold | 3D Hindi Kahaniya #Shorts(90文字)

2. Infobells Lea

…

[翻訳のため中断]

Individual skills in this repo

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

関連スキル