Communitygithub.com

Hownameee/short-videos

共有ショートビデオワークフローのフェーズ2を実行します。明示的に選択された方向性とそのリサーチを基に、レビュー可能なビートシート、ナレーション、柔軟なシーンタイミング、オンスクリーンテキスト、ビジュアル計画、キャプション、音楽とSFXキュー、発音ノート、ペイオフ、テイクアウェイ、コンテキストに応じたCTAを作成します。ユーザーがショートビデオのスクリプト作成、修正、プレビュー、承認を依頼したときに使用します。スクリプト承認までで停止し、TTSや動画レンダリングはまだ行いません。

short-videos とは?

このスキルは、ショートビデオ制作ワークフローのフェーズ2を担当し、選択された方向性とリサーチを基に、レビュー可能なスクリプトとシーン計画を作成します。開発者やAIエージェントユーザーが「スクリプトを書いて」「修正して」「プレビューして」「承認して」と依頼した際に、リサーチの整合性を確認しながら、ビート構造(緊張フック、約束、ユースケース設定、説明、ペイオフ、テイクアウェイ、CTA)に従い、各シーンにナレーション、オンスクリーンテキスト、ビジュアル指示、キャプション、音楽、SFX、発音メモを詳細に記述します。時間予算(各セクションの秒数)を考慮し、オーバーなシーンはテキスト調整やシーン分割で対処します。出力は人間が読めるscript.mdとして提示され、承認を得てから次のフェーズ(動画制作)に移ります。主なプラットフォームはRemotion Studioベースのワークフローを想定しており、CodexやCursorなどのAIエージェント上で動作します。このスキルは、ユーザーがTTS生成やレンダリングを要求する前に停止し、明確な承認を待つことで、品質を担保します。

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

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

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

ドキュメント

ショートビデオスクリプト

フェーズ2を担当します。選択された方向性とそのリサーチを事前に読んでから作成に取りかかってください。出力を永続化する際はアーティファクト契約に従ってください。

前提条件

方向性が明示的に選択されていることを確認してください。不足している場合はshort-video-discoveryにルーティングして戻します。ユーザーが自動選択を依頼した場合を除き、黙って方向性を選択しないでください。自動選択の場合は推奨方向性を使用し、その仮定を記録してください。

選択された方向性が現在のリサーチバージョンを参照していることを要求します。リサーチが欠落しているか古い場合は、停止してフェーズ1を修復してください。メモリからギャップを埋めないでください。

リサーチよりも強いフックは却下または弱めてください。事実の主張には、ソースIDをシーン計画まで保持してください。

2パスで作成

ビートシート

洗練されたナレーションを作成する前に、各ビートの役割を定義します。

  1. 緊張フック;
  2. 約束(フックと重複可);
  3. 必要に応じてユースケース設定;
  4. 1~3の説明またはデモンストレーションのビート;
  5. 証拠または結果によるペイオフ;
  6. 一文のテイクアウェイ;
  7. コンテキストに応じたCTA(ペイオフと重複可)。

時間を予算として扱います。

セクション標準的な長さ
緊張フック3~7秒
約束2~5秒
ユースケース設定4~10秒
説明/デモ20~40秒
ペイオフ/証拠5~15秒
テイクアウェイ2~6秒
コンテキストCTA2~6秒

予算は重複しても構いません。目標時間を埋める必要はありません。ペイオフが完了したら早期に終了してください。

スクリプトとシーン計画

聴くために書きます:短い節、一文につき一つのアイデア、具体的な動詞、自然な間。挨拶、スタンドアロンのロゴイントロ、密度の高いリスト、偽の個人体験、裏付けのない統計は避けてください。

すべてのシーンに対して以下を提供してください。

  • 目的と柔軟な長さ;
  • 正確なナレーション;
  • オンスクリーンテキスト;
  • ビジュアルの種類、アクション、アセット要件;
  • キャプショングループ化の意図;
  • 音楽とSFXキュー;
  • トランジション;
  • ソースID;
  • 頭字語、製品名、数字、URLに対するKokoro発音メモ。

リポジトリのプロダクションデフォルトを適用してください。新しい動画は、明示的に上書きされない限りmeta.width: 2160、meta.height: 3840、meta.fps: 60を使用します。リクエストの記録されたフォーマットに従ってください。古い1080p/30fpsプロジェクトのメタデータを新しいデフォルトスクリプトにコピーしないでください。ドラフトコマンドは、承認前に欠落しているフォーマットフィールドを埋めます。モーションは秒単位で計画し、その速度はfpsに依存しないようにします。英語出力、captions.mode: "word-highlight"、およびシーンごとの具体的なモーションプランのデフォルトを維持します。何が視覚的に変化するか、そのナレーションキュー、最終状態を記録してください。「スライドをフェードイン」だけではシーンのモーションプランになりません。キャプショングループは1行または2行でデザインしてください。実際の単語のタイミングは音声生成から得られるものであり、スクリプトからではありません。

プロダクションノートに、デフォルトのコンパクトなサウンドプランを含めてください。意図する感情、フック/説明/リビール/エンディングを通した音楽、ダッキング、ナレーションまたはビジュアルに関連した選択的なアクセントキュー。「アンビエント音楽」や空のSFXリストだけではサウンドプランになりません。別途リマインダーを必要とせずにプロダクションに引き継ぎます。明示的なユーザーのサウンドオーバーライドを尊重し記録します。

ユーザーが詳細なアートディレクションを要求した場合、またはシーン計画が具体的なレイアウト、タイポグラフィ、色、図、キャプション、モーション、トランジションの動作を定義する場合は、../short-video-visual-design/SKILL.mdを読んでください。フェーズ2ではビジュアル計画を編集レベルに保ちます。詳細なJSXはフェーズ3の作業です。

発音のスペルは、試聴するための候補として扱い、権威あるレンダリング指示としては扱いません。これは、選択されたTTSプロバイダーにスクリプト言語の公式音声がない場合に重要です。

スピーチ時間を見積もり、密度が高すぎるシーンにフラグを立てます。長すぎるシーンを盲目的にTTS速度を上げて解決しないでください。まずテキストを短くするか、シーンを拡張してください。

レビューフォーマット

以下の順序で簡潔で人間が読めるscript.mdを提示します。

  1. タイトル、オーディエンス、時間範囲、トーン;
  2. フック、約束、ペイオフ、テイクアウェイ、CTA;
  3. ビート機能、ナレーション、プロダクションノートを含む1つのシーンテーブル;
  4. テーブルから明らかでないソース、発音候補、仮定、警告のみ;
  5. 推定合計時間。

1つの決定を求めます:スクリプトを承認するか、改訂リストを提示するか。承認が保留中は、Kokoroを呼び出さず、プロダクションアセットを取得せず、Remotion Studioを起動せず、レンダリングもしないでください。

編集をvideo script --draftで記録します(プロダクション後もサポート)。明示的な承認後はvideo script --approveを使用してください。ハッシュや承認タイムスタンプを手動で設定しないでください。script_approvedを記録します。ユーザーがプレビューまたは最終レンダリングを要求した場合にのみshort-video-productionにルーティングします。承認だけではゲートで待機します。

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

>- Run Phase 1 of the shared short-video workflow: turn a raw topic or prompt into a sourced research pack and 2–4 distinct video directions, each with a defensible tension hook, promise, payoff, beats, visual approach, duration range, and risks. Use whenever the user asks for video ideas, angles, research, facts, hooks, topic analysis, or choices before scriptwriting. Stop for the user's direction choice and do not silently continue into script or production.

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

>- 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.

関連スキル