Communitygithub.com

Pedrovbm1/guion

短い説明動画(Reel、TikTok、Short、3Dアニメーション解説)のスクリプトを作成します。調査済みのデータと出典を記載し、1文に1アイデアを日常会話調で記述。音声やアニメーション制作前に、保持率・データ・明確性の3名のレビュアーによる第0ラウンドを実施し、閾値を満たすまで修正を繰り返します。「スクリプトが欲しい」「動画のテキストを書いて」「Xを動画で説明して」といった依頼や、参考動画をもとに「同じようなもの」を作る場合に使用します。

guion とは?

このスキルは、短尺の説明動画(Reel、TikTok、YouTube Short、3Dアニメーション解説)向けのスクリプトを作成するためのものです。ユーザーが「スクリプト」「動画のテキスト」などを依頼したとき、または参考動画を送って「同じようなもの」を要求したときに起動します。最大の特徴は、音声やアニメーションにコストをかける前に、テキストベースで厳密な品質チェック(第0ラウンド)を行う点です。まず、ユーザーのアイデアをヒアリングし、必要な情報を最大4つの質問で一度に収集します。次に、すべての事実確認可能なデータに出典を付けて調査します。その後、1文1アイデア、日常会話調、3秒以内のフック、5~8秒ごとのミニフック、ループ構造などの厳格なスタイルルールに従ってスクリプトを執筆します。そして、保持率(A)、データの正確性(B)、初心者への明確性(C)の3人の独立したレビュアー(サブエージェント)が同時にチェックし、Aが9以上、Cが9以上、Bに深刻な問題がない状態になるまで修正を繰り返します。最終的に「GUION LISTO(スクリプト完成)」という停止ポイントでユーザーの承認を待ちます。これにより、動画制作の早い段階でスクリプトの問題を発見し、後戻りコストを大幅に削減します。Claude Code、Cursor、Codexなど、サブエージェントを並列実行できるAIエージェントプラットフォームで利用できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pedrovbm1/explicadores-3d/tree/main/skills/guion

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

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

ドキュメント

説明動画のスクリプト

スクリプトの修正は最も安価ですが、問題を後から発見すると最も高くつきます。動画が完成してからスクリプトをやり直すには何時間もかかりますが、テキストで読むのは1分です。そのため、このスキルは必ずGUION LISTOで停止します。

出力:プロジェクトフォルダ内に voz/frases.txt(1行1フレーズ)、MAPA.md(視覚的スクリプト+出典付きデータ)、DECISIONES.md を作成します。explicadorスキルと連携する場合、プロジェクトは既に nuevo.py で作成されており、MAPAは escena/CONTRATO.md の下書きとなります。

1. アイデアを受け取る

  • 動画のリンクが送られた場合、ver-videoスキルで分析します。他人の動画からはテーマと、それがうまく機能している理由(フック、リズム、構造)のみを抽出します。決してそのスクリプト、フレーズ、画像、音楽を流用してはいけません。
  • 不明な点は1つのブロック(最大4つの質問)で尋ねます:ターゲット視聴者、尺、単発かシリーズの一部か、トーン。ユーザーが決定した内容は日付入りで DECISIONES.md に記録します(コンテキストを圧縮した後、再読します)。

2. 出典付きで調査する

  • すべての数字、日付、検証可能な主張には出典を付けます(リンク+内容)。信頼できる出典がない場合は記載しません。出典が一致しない場合は、「10~15」「推定される」など曖昧に表現します。
  • 「なぜ」の説明が理論や仮説である場合は、「提唱されている」「一つの考えとしては」と明記します。
  • 創作の「例えば」は、「仮に8cmだとしましょう」のように例であることを明示します。
  • 検索はサブエージェント(努力度 high)に委任できますが、主要な出典は自分で確認します。
  • すべてを MAPA.md の「検証済みデータ」セクションに記録します:データ・出典・短い引用。

3. 執筆する

スタイルルール(これらが保持率と明確性を最も向上させます):

  1. 1文1アイデア。 「さらに」「しかし」や条件が重なった文は分割します。
  2. 日常会話調。 友達に話すように、日常的な言葉、家庭や仕事の例を使います。専門用語は最初に説明するか、使用しません。
  3. 3秒以内にフック(遅くとも4.5秒)。 好奇心をそそる質問か、視聴者の常識を覆す内容。フレーム0は音声なしでも理解できるように:鮮明な画像+書き言葉の質問。
  4. 約束と代償: フックが約束したことは必ず果たし、目に見える形で示します。
  5. 5~8秒ごとにミニフック(「でも待って」「ここが変なところ」)。
  6. 冒頭に戻るエンディング(ループ)と、ありきたりでないコメント誘導の質問。
  7. 尺: 音声は約16文字/秒(約3語/秒)。単発動画は15~30秒が最適。60秒を超えるのは、名前と番号が付いたシリーズの一部のみ。
  8. 他のクリエイターのフレーズや決まり文句をコピーしない。
  9. 3Dアニメーションの場合:目に見えるものや、目のように見える同じ円のペア(リング付きオーブ、双子の窓、アーチが乗った円盤)を避けます。 対象が丸い場合、MAPAにどのように描画して目に見えないようにするかを記載します。

voz/frases.txt とMAPAを作成します:各フレーズ、そのキーワード(画像切り替えのトリガー)、そのキーワードで何が見えるか、テロップがあればその正確な文言、おおよその秒数を表にします。

4. MAPAに関する第0ラウンド(音声とアニメーション前のテキストのみ)

3人の独立したレビュアーを並行して起動します(サブエージェント、中程度のモデル(Sonnet程度)、努力度 medium。Bのみ high)。各レビュアーは voz/frases.txt と MAPA.md を読み、他のレビュアーの内容は読みません。revision/REV_<レビュアー記号>_mapa_v<N>.md に10点満点の評価と具体的な修正箇所(どのフレーズ、どの単語、どのテロップ)を出力します。指示は RONDA0.md にあります。

  • A・保持率: 音声なしのフレーム0、3秒以内のフック、約束と代償、ミニフック、5秒以上画像が変わらない区間、ループ、最後の質問、尺。
  • B・データ: 各数字とその出典の照合(レビュアーが確認)、発言されたすべての数字にテロップがあること、MAPAにないものが画面に表示されていないこと。
  • C・初心者への明確性: 15歳の視点でスクリプトを再度説明。説明されていない単語、名前、略語、数字をリストアップ。複数のアイデアを含む文や小さな文字(「一般的に」「シナリオであって予測ではない」)を指摘。各フレーズの書き直し案を提案し、尺を確定。

修正を適用し、A ≥ 9、C ≥ 9、Bに高レベルの問題がない状態になるまで繰り返します。最大2ラウンド。2ラウンド目で合格しない場合は、そこで停止し、ユーザーにスクリプトと注釈を送ります:動画は作成しません。

5. GUION LISTO(必須の停止ポイント)

ユーザーに、1つのメッセージで、チャット内に(ファイルとしてではなく)送信します:

  • プレーンテキストのスクリプト(10~12行)、
  • 推定尺と第0ラウンドの注釈、
  • 出典付きデータ、
  • 最大4つの質問。

自身のターンを GUION LISTO で終了します。ユーザーが応答するまで音声を生成したりアニメーターを起動したりしてはいけません。ユーザーが「一気にやって」と言った場合でも、このステップはスキップできません。調査と構築には適用されますが、ここには適用されません。

Individual skills in this repo

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

関連スキル