Communitygithub.com

ショートビデオディスカバリー

ユーザーのトピックやプロンプトから、裏付けのあるリサーチパックと2〜4の異なるビデオ方向性(緊張感のあるフック、約束、見返り、ビート、ビジュアルアプローチ、時間範囲、リスクを含む)を生成する、共有ショートビデオワークフローのフェーズ1を実行します。スクリプト作成前に、ユーザーが方向性を選択できるようにそこで停止します。

ショートビデオディスカバリー とは?

このスキルは、ショート動画ワークフローの最初のフェーズ(ディスカバリーフェーズ)を担当します。ユーザーが動画のアイデアやリサーチをリクエストした際に、まずプロジェクトフォルダを作成・管理し、トピック、対象視聴者、プラットフォーム、トーンなどの前提条件を抽出します。その後、検証可能な事実と創造的なフレーミングを区別しながら、信頼できる情報源(ウェブ検索やユーザー提供資料など)を利用してコンパクトなファクトパック(3〜7件の主張)を構築します。リサーチ結果に基づき、異なるナラティブロジック(例:痛みのユースケース、通説の訂正、結果ファーストのデモ、ビジュアルアナロジー、比較、ミニストーリー)を持つ2〜4のビデオ方向性を生成し、それぞれにタイトル、フック、約束、ビート、ビジュアルアプローチ、制作リスクを詳細に記述します。最後に、各方向性のフックを明確さ、真実性、視聴者への関連性、見返りの観点でスコアリングし(真実に反するフックは却下)、最も推奨される方向性を1つ提案します。重要なのは、スクリプト作成やプロダクションに進まず、ユーザーに方向性の選択を促すところで停止することです。このフェーズでは、`request.json`、`state.json`、`research.md`、`research.json`、`directions.json`などのアーティファクトを永続化します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/short-video-discovery

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

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

ドキュメント

ショートビデオディスカバリー は何をしますか?

フェーズ1を担当します。出力を永続化する際はアーティファクト契約を使用してください。

インプット

ユーザーが新しい動画ワークフローを開始したり、制作予定の動画についてブレインストーミングを依頼した場合、まず既存のprojects/<nnn>-*フォルダをスキャンし、001から始まる次のゼロ埋め番号を割り当て、安定したスラッグを導出し、プロジェクトフォルダを作成して、request_created状態でrequest.jsonとstate.jsonを永続化します。再開時は提供されたプロジェクトを再利用します。一般的な読み取り専用の議論であり、動画制作の意図がない場合はプロジェクトを作成しないでください。

何かを質問する前に、ユーザーがすでに提供した情報を抽出します:

  • トピックと望ましい成果;
  • 視聴者と想定される知識;
  • プラットフォームと時間範囲;
  • 言語、トーン、緊張レベル、CTA目標;
  • 許可または禁止されている主張、情報源、メディア、プロバイダー。

副次的な詳細には妥当なデフォルト値を使用します。欠落した回答がリサーチの範囲や安全性を大きく変える可能性がある場合にのみ、早い段階で質問します。デフォルト値はassumptionsに記録します。

リサーチ

変更される可能性がある、または重大な結果をもたらす主張については、最新の一次情報または権威ある情報源を使用します。以下を区別します:

  • 直接の情報源による検証済み事実;
  • 引用された事実から導き出された推論;
  • 創造的なフレーミング;
  • 未解決または却下された主張。

LLMのメモリをウェブリサーチとして扱わないでください。OllamaのようなローカルLLMは証拠を整理し方向性を生成できますが、現在の証拠を得るためには検索アダプター、取得したURL、またはユーザー提供の情報源パックが必要です。

3〜7件の有用な主張でコンパクトなファクトパックを構築します。各主張について、ステートメント、ソースURL、発行者、日付(入手可能な場合)、信頼度、および動画で安全にサポートできる内容を記録します。方向性に影響を与えない事実は収集しないでください。

方向性の生成

単なる表現の違いではなく、ナラティブロジックが異なる2〜4のオプションを作成します。有用なカテゴリには以下が含まれます:

  • 痛みや失敗のユースケース;
  • 実際の誤解に対する逆張り的な訂正;
  • 結果ファーストのデモンストレーション;
  • ビジュアルアナロジー;
  • 比較またはビフォーアフター;
  • 決断と結果を伴うミニストーリー。

すべての方向性に以下を含めます:

  1. 仮タイトル;
  2. 視聴者の問題;
  3. 緊張感のあるフック;
  4. 約束と見返り;
  5. 2〜3の中核ビート;
  6. 利用可能な証拠と弱い主張;
  7. ビジュアルアプローチと想定されるアセットソース;
  8. 音楽のムードとペーシング;
  9. 時間範囲;
  10. 制作の複雑さとリスク。

フックを明確さ、真実性、視聴者への関連性、見返りの観点で0〜2でスコアリングします。魅力的に聞こえても真実性に欠けるフックは却下します。すべてのオプションを同じ完璧なスコアに水増ししないでください。スコアが同点の場合は、実際のトレードオフを説明し、視聴者への適合性、証拠の強さ、ビジュアルの見返りに基づいて選択します。1つの方向性を推奨し、そのトレードオフを1〜2文で説明します。

ゲートの提示

重複しない比較表を1つ使用し、その後におすすめと1つのコンパクトな質問を提示します。ユーザーにオプションの選択、名前付きオプションの組み合わせ、または新しい方向性のリクエストを促します。時間、緊張感、CTAについては、それらが依然として重要で未解決の場合のみ質問します。

この最初のパスはdirections_proposedで終了します。選択リクエストの後で停止します。完全なナレーションの作成、Kokoroの呼び出し、アセットのダウンロード、Remotionコードの作成、またはレンダリングは行いません。

アーティファクトを永続化する際は、以下を書き込みます:

  • リサーチ開始前にrequest.jsonとstate.json;
  • 人間用のresearch.md;
  • 主張と出典用のresearch.json;
  • 選択肢用のdirections.json;
  • ユーザーが選択し、状態がdirection_selectedに移行した後にのみdirection.json。

どの事実がまだ不確かで、フェーズ2のためにどの選択が必要かを報告します。

Individual skills in this repo

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

Hownameee/short-videos

Generate, revise or troubleshoot local Kokoro narration, pronunciation and scene word timing. Reuse verified unchanged clips; inspect the Python environment before setup changes. Exclude research, visuals, music composition and publishing.

Hownameee/short-videos

Router for all Remotion skills

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Structure Remotion markup for interactivity

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

Produce an approved short video or correct an existing video's background sound, emotion, captions, mix or export. Generate only changed narration, render and review a current preview, run technical and editorial QC, then export. Exclude script-only and general audio-advice requests.

Hownameee/short-videos

>- Run Phase 2 of the shared short-video workflow: convert an explicitly selected direction and its research into a reviewable beat sheet, narration, flexible scene timing, on-screen text, visual plan, captions, music and SFX cues, pronunciation notes, payoff, takeaway, and contextual CTA. Use whenever a user asks to write, revise, preview, or approve a short-video script. Stop for script approval and do not generate TTS or render video yet.

Hownameee/short-videos

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

関連スキル