Communitygithub.com

Akira-TL/akira-video-skills

SHOTS.md のショット一覧を、直接制作可能な個別ショット定義に展開します。ビデオ/shots/<shot-id>/SHOT.md の作成や変更、ショットの連続性、撮影、アクション、演技、音声、またはショット固有の制作制約が必要な場合に使用します。

akira-video-skills とは?

このスキルは、動画生成と編集の核となる作業単位である「ショット」を管理するためのものです。`SHOTS.md` から個別のショット定義 (`video/shots/<shot-id>/SHOT.md`) を作成・編集する際に使用し、プロンプトのコンパイルや生成結果のレビューは担当しません。ショットを展開する前に、`references/planning/COVERAGE.md` を参照して必要なカバレッジ(マスターショット、リアクション、インサート、プロダクトクローズアップなど)が実際に必要かどうかを判断するよう指示します。ショット ID は空き番号方式(例: SC01_SH010)を使用し、複雑なプロジェクトではディレクトリを追加して整理します。カメラ言語やインタラクションなど、特定の側面については関連するリファレンスドキュメントを参照し、必要最小限の情報のみを含めた `SHOT.md`(ショットの目的、時間、フレーミング、アクション、連続性情報、ハード制約など)を作成します。このスキルは、モデルに依存しないショット設計と、モデル固有のプロンプト最適化を明確に分離することを目的としており、Claude Code、Cursor、Codex などの AI エージェントで動作します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/video-shot

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

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

ドキュメント

ビデオショット

各ショットは、動画生成と編集の中核となる作業単位です。このスキルは video/shots/<shot-id>/SHOT.md を所有しますが、モデル固有のプロンプトコンパイルや生成結果のレビュー結論は所有しません。

SHOTS.md から一連のショットを展開する前に、そのシーンにいくつかの観測ポイントが必要か、マスターショット/リアクション/インサート/プロダクトクローズアップが実際に有用かを、references/planning/COVERAGE.md に従って判断してください。固定のカバレッジパッケージを機械的に適用しないでください。

1. ショット ID とディレクトリの確立

デフォルトでは空き番号方式を使用します。例:SC01_SH010、SC01_SH020。シーンのないシンプルなプロジェクトでは SH010 を使用します。ショットを途中に挿入する必要がある場合は、読みやすい中間番号を使用し、既存の ID を振り直さないでください。

複雑なプロジェクトでは、フラットなリストがブラウジングの妨げになる場合にのみ、video/shots/ 内に章などの整理用ディレクトリを追加します。

ショットに複雑な撮影、アクション、クロスワールドトランジション、または連続性が含まれる場合は、references/direction/DIRECTION.md を読み込んでください。ショットサイズ、焦点距離/パース、カメラ位置、パン/ズーム、被写界深度、フォーカス、またはプロダクト撮影を明確にする必要がある場合は、references/direction/CAMERA-LANGUAGE.md を読み込み、最初に可視的な撮影効果を定義し、その後でモデルアダプターが具体的な用語を決定するようにします。複数人物の接触、物の受け渡し、手の操作、プロダクトの使用、複雑な遮蔽、または機械的なインタラクションがある場合は、references/direction/INTERACTION.md を読み込み、アクションの主体となるキャラクター、手、接触点、アクションの前後状態を明確にします。複数ショットのプロジェクトで、高コストな生成の前に順序、ダイアログ、総尺、またはプロダクトの可読性を検証する必要がある場合、references/planning/PREVIS.md では、ストーリーボードと仮の音声を使用した軽量な動的絵コンテ(Animatic)を許可します。すべてのプロジェクトでこれを行う必要はありません。ショットが前のショットの実際の出力を待つ必要があるか、どのショットを並行して実行できるか、計画された出力/実際の出力の引き継ぎ方法については、references/continuity/CONTINUITY-HANDOFF.md に従ってください。複数キャラクターのブロッキング、製品/機械的インタラクション、複雑なカメラパス、開始/終了フレームの制御、または隣接するショット間の空間関係について、本生成の前にまだ大きな不確実性がある場合は、references/planning/PREVIS.md を読み込み、必要最小限のプレビジュアライゼーション/ストーリーボードを作成します。

2. SHOT.md を書く

複雑なショットや外部に生成を委託するショットは、references/planning/SHOT-TEMPLATE.md に従って直接記述できます。シンプルなショットは、本当に必要なフィールドのみを保持します。VIDEO.md が複数のアスペクト比バージョンを明示的に要求している場合のみ、references/planning/MULTI-FORMAT.md を読み込み、メインバージョンからの切り抜きで対応できるか、独立した構図/生成が必要かを判断します。

SHOT.md には、現在有効なショットデザインのみを保存します。通常、以下を含みます:

  • ショットの目的;
  • 目標時間(現在のスクリプト/総尺予算から決定しますが、それでもこのショットの実際のアクションとダイアログに従います);
  • ショットサイズ、カメラ位置、カメラの動き、および必要な焦点距離情報;
  • 被写体の立ち位置、アクション、演技、表情;
  • 環境と重要な小道具;
  • ダイアログ、環境音、ショット固有の音声;
  • インテグレーションイン/インテグレーションアウト;
  • 現在参照すべき再利用アセット;
  • ハード制約;
  • モデルアダプテーションレイヤーが調整できる生成指示。

すべてのショットにすべてのフィールドが必要なわけではありません。シンプルなショットは簡潔に保ちます。

3. 連続性

連続性は、隣接するショットに本当に関係する情報のみを記録します。例:人物の位置、衣装、手に持っているもの、小道具の状態、光源の方向、動きの方向、すでに発生したアクション。

前のショットの実際の生成結果に許容範囲内のずれがある場合、次のショットはその実際の可視状態から継続します。そのずれがキャラクターのアイデンティティ、製品の実際の構造、またはその他のハード制約に違反する場合、その生成結果は連続性の根拠として使用されるべきではありません。

4. 撮影とアクション

カメラの動きは、情報、関係性、空間、または感情にサービスするものでなければならず、「映画的な見た目」のための機械的な動きであってはなりません。ビデオモデルのアクションデザインは、秒単位の時間関係を優先して使用し、ポストプロダクションでなければ正確に実現できないフレームレベルの制御を、モデルのハード制約として記述しないでください。

1つのショットに複雑な内部アクションを含めることはできますが、なぜそれが編集の中で1つのショットであるのかを明確に説明できなければなりません。モデルが1回の生成で複数のカットを含む場合でも、プロジェクトは最終的なショットの意味論に従って整理します。モデルの能力のために、複数のショットを恒久的に1つのオブジェクトに統合しないでください。

同一ショットのトリミング、カラーグレーディング、音声の差し替え、マルチフォーマット派生、および真に新しいショットの境界は、references/continuity/SHOT-DERIVATIVES.md に従います。ポストプロダクション派生は、ショットディレクトリ内の元の takeNN.mp4 を上書きできません。

5. 生成前チェック

ショットを video-generation に渡す準備ができたら、以下を確認します:

  • ショットの目的が明確であること;
  • 目標時間とアクションの量が互換性があること;
  • 再利用が必要なキャラクター/シーン/製品などのデザインが確定していること;
  • インテグレーションイン/アウトが隣接ショットに対して十分に明確であること;
  • 参照アセットの役割が明確であること;
  • ハード制約と通常のプリファレンスが区別されていること;
  • 字幕、ロゴ、正確なカットポイントなど、明らかにポストプロダクションのタスクが生成のハード制約として誤って記述されていないこと。

条件を満たさない場合は、まず SHOT.md または上流のデザインを修正し、「とりあえず生成してみる」でショットデザインを代替しないでください。

6. プロンプトと生成結果の帰属

長期プロンプトバージョンと生成結果は、ショットと同じディレクトリに配置します:

prompt_v01.md prompt_v02.md take01.mp4 take02.mp4

プロンプトの具体的なモデルコンパイルと1回限りの生成パッケージは video-generation が担当します。生成結果の選択、再生成、およびポストプロダクション修正の判断は video-review が担当します。

完了基準

SHOT.md は、生成スキルが監督の意図を再推測することなくプロンプトをコンパイルでき、かつそのショットが何を継承しなければならず、終了時に何を残すのかを明確にできるものでなければなりません。

Individual skills in this repo

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

Akira-TL/akira-video-skills

为 Runway 当前视频模型编译和检查生成提示词;当 video-generation 需要使用 Runway(当前主线 Gen-4.5)的 Text to Video 或 Image to Video,并需要 Runway 专用动作、摄影和时序表达时使用。

Akira-TL/akira-video-skills

为 ByteDance / BytePlus Seedance 当前视频模型编译和检查提示词;当 video-generation 需要使用 Seedance 2.5 的参考素材、时间线、同步声音、视频编辑、延长或多镜头能力时使用。

Akira-TL/akira-video-skills

为 Google Veo 视频生成编译和检查提示词;当 video-generation 需要使用 Veo 的 Text to Video、Image to Video、首尾帧、参考元素或同步声音能力时使用,并先核验具体 Google 使用入口与 model 的当前支持范围。

Akira-TL/akira-video-skills

进入并持续推进一个 AI 视频制作项目;读取或建立 VIDEO.md,根据当前视频脚本、复用素材、镜头、生成结果和整片后期状态,按需路由到 canonical 视频专业 Skill,而不是把所有制作规则塞进一个总提示词。

Akira-TL/akira-video-skills

为品牌短片、产品植入剧情、广告或比赛作品建立产品事实与广告边界;当视频需要准确表达某个具体产品的官方功能、参数、结构、使用方式、品牌素材或产品与剧情关系时使用。

Akira-TL/akira-video-skills

设计并维护 AI 视频中跨镜头复用的角色声音、音色参考、对白声音要求与整片声音关系;当同一角色需要跨镜头保持声音一致,或需要规划语音参考、环境声、音效、音乐与画面的职责边界时使用。

Akira-TL/akira-video-skills

设计 AI 视频中的角色与场景视觉方案;当脚本只说明“需要一个什么样的人/场景”,但还没有形成可稳定生成的外形、服装、材质、色彩、空间、光线和视觉识别系统时使用。

Akira-TL/akira-video-skills

组织整片级剪辑、合成、全片声音和最终成片;当多个已采用镜头需要进入 Premiere Pro、After Effects、DaVinci Resolve 等后期工程,或需要整片字幕、Logo、音乐、混音、比例版本和最终导出时使用。

Akira-TL/akira-video-skills

为 AI 图片或视频生成准备可直接使用的提示词与一次性生成包,并在用户把生成结果带回项目后归档;当需要从正式视频脚本、复用素材和 SHOT.md 编译生成内容、选择参考素材、约定返回文件名或清理临时包时使用。

Akira-TL/akira-video-skills

规划、创建、整理和维护多个镜头会重复使用的视频复用素材;当需要人物/场景/道具/产品提示词、参考图、官方素材、身份与状态参考或其他可重复引用内容时使用。

Akira-TL/akira-video-skills

审核 AI 生成的人物/场景等复用素材或镜头生成结果,判断采用、修改提示词、重生成还是留给后期修复;当生成结果返回项目、需要检查身份/结构/连续性/动作/摄影/产品真实性或选择生成结果时使用。

Akira-TL/akira-video-skills

把小说、章节、故事梗概、品牌 brief 或其他上游内容转换成当前视频自己的脚本层;当需要编写或修订 SCRIPT.md、视频人物表演定义、场景定义、对白或镜头总表时使用。

関連スキル