Communitygithub.com

shorts-director

顔のない縦型ショート動画を、アイデアから完成・マスタリングまで監督し、実行ごとに改善していくスキルです。

shorts-director とは?

このスキルは、AIエージェントが「顔のない縦型ショート動画」(解説、スキット、ドキュメンタリーなど)をゼロから制作・監督するためのものです。単なる動画生成ではなく、「ライターズルーム」での脚本執筆、音声収録、アニマティック(絵コンテ)作成、そして1カットごとに最適なレンダリング手法(コード描画、生成画像からの切り抜き、動画クリップ生成、エンジン定義トラック)を選択する、高度な制作パイプラインを提供します。品質に重点を置き、各工程にはゲート(承認ポイント)が設けられ、無駄なコストを防ぎます。エピソードシリーズ化、新しいフォーマットの開拓、そして毎回の制作後に学習・改善するループ機能(improveモード)を持ち、使い込むほどに精度が向上します。対応プラットフォームは主にRemotionベースのエンジンで、Claude Codeや他のエージェントフレームワーク上で動作します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gbax316/shorts-director/tree/main/.claude/skills/shorts-director

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

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

ドキュメント

Shorts Director(ショート監督)

ショート動画は、何の義務もない誰かに2秒で判断される。このスキルのすべては、あなたが手渡す最初のカットが、まさにオーナーが投稿したいと思うものになるために存在する:3つの中から選ばれたアイデア、画面上で見え、かつ聞こえる言葉、オーナーがあなたより先に見つけるフレームの欠陥がないこと、そしてダンフォ(ナイジェリアの乗り合いバス)のスマホでも再生できるサウンドミックス。品質が最優先される。コストはすべての支出前に表示され、上限として扱われることはない。

このスキルは「監督」し、リポジトリのエンジンが作業を行う。エンジントラック(Remotionキット、クリップ・画像ツール、ニッチなライブラリ、コラージュカメラ)と、その後追加されたツール(口同期、共有カード、キャプションチャンカー、チェック)は、このスキルがビートごとに選択するレンダリングパスであり、動画ごとに1つのトラックではない。

何よりも先に:設定とバイブルを読む

アイデンティティは設定ファイルにあり、スキル内にはない。リポジトリルートの director.config.json を読み、ブランド、コーナーマーク、作品に登場する人物、リンクタグ付け、ハウスルール、プロバイダーとその価格、マスタリングターゲットを確認する。視覚的アイデンティティ(色、フォント、ロゴ)は remotion/src/brand.ts と remotion/src/fonts.ts にある。ショートがシリーズに属する場合は、1行書く前に ai-shorts/series/<series>/BIBLE.md のバイブルを読む。新しいチャンネルやキャストの場合は、シリーズモードが先にバイブルを作成する。その後、RUNS.md と LESSONS.md の最後のエントリを数件読み込む。なぜなら、前回の実行の欠点は、今回の実行で避けるのが最もコストがかからないからだ。

モード

モードその役割読むファイル
series継続キャストまたはチャンネルスタイルのバイブルmodes/series.md
writers-room購入者として判断される3つの異なる前提、次に脚本modes/writers-room.md
produce音声、アニマティック、静止画、クリップ、口、構成modes/produce.md
sound背景音、キュー、ミックスとマスタリングmodes/sound.md
finishマスター、電話コピー、テキストチェック、投稿パックmodes/finish.md
bakeoffデフォルトにする前にモデル同士を試すmodes/bakeoff.md
effects/effects <名前>:エフェクトのプレビュー、ビートへの配置、またはライブラリへの新規エフェクトの構築modes/effects.md
improve毎回のショート後:実行をスコアリング、教訓の記録、スキル変更の提案modes/improve.md

新しいショートは順番に実行される:series(バイブルがない場合のみ)、writers-room、produce、sound、finish、improve。オーナーはモード名でいつでも開始でき、明らかに1つのモードに該当するリクエスト(音声再収録、キャプション修正、新しいフック)は直接そこへ進む。

高速レーン。 シリーズバイブルが存在し、フォーマットが実証され、エンジンが既知の場合、何もスキップせずにすべてを短縮する:長い前提審査の代わりに1回のパス、シリーズで適合する静止画を再利用する。ゲートとチェックはそのままに、ラウンドだけを減らす。

すべての実行で保持されるゲート

これらはオーナーの目が行く順序であり、作業は彼らが回答するまで停止する。各ゲートでの変更は安価だが、後になるほど高価になる。

  1. 前提。 3つ、購入者として書かれ判断され、選択とその理由。どれかが選ばれるまで音声は収録されない。
  2. 音声。 オーナーが指定した部分はオーナーの言葉通り。ピジン語やローカル名の場合は、聴いて選んでもらう音声オーディション(references/voice.md)。選ばれたテイクは正確に配置され、再生成されることはない。
  3. アニマティック。 実際の音声タイムライン上に、コード描画ギャグを含む静止画、クリップが入る場所にキャプションと赤タグを配置。アニマティックが承認されるまでクリップは生成されない。
  4. 支出。 すべての生成ステップは、まずクレジットまたはドルを明示し(references/stills-and-clips.md)、その後合計が報告される。
  5. カット。 オーナーはマスタリング前にラフカットを視聴し、完成ファイルは投稿前に視聴する。

ゲートの間は、references/qa.md の記述に従って自分の作業をチェックし、オーナーの目が味覚にのみ使われ、スキャンで発見できた欠陥に費やされないようにする。

フォーマット

フォーマットは独自の文法(ビートの進行方法)、独自のビジュアルワールド、独自のデフォルトレンダリングパスをもたらす。現在までに実証されたものはそれぞれリファレンスを持つ:

  • references/formats/skit.md:継続キャストによる対話(AkposとSegs、エピソード1と2で実証)
  • references/formats/documentary.md:ナレーターがフォトリアルなシーンと出典付きの人物を解説(Qodeupミニドキュメンタリー1で実証)

エンジンフォーマットも引き続き利用可能:コード描画の解説動画は make-short と vidtsx-2d-generator、コラージュは make-vox。監督はショート全体をそのうちの1つにルーティングするか、1ビートを借用できる。

要求されたフォーマットがまだ実証されていない場合

オーナーが既存フォーマットのいずれもカバーしない種類のショート(リスト記事、ビフォーアフター、擬人化された物体、ニュースまとめ)を要求した場合、無理に最も近いフォーマットに押し込まず、その旨を率直に伝える。ニュースまとめにスキットの文法を使うと、オーナーが気づく違和感が生まれる。2つの道を提示する。1つ目は適切にセットアップする:実証ランとして実行し、出荷後、os-skillify を使って実行で実証された内容から references/formats/<名前>.md を作成し、次回は推測ではなく文法から始められるようにする。2つ目は、最も近いフォーマットを足場として一度だけ作成し、ギャップを明示し、何も保存しない。同じ新しいフォーマットが2回目に来た場合は、最初の道を取る。即興で改善され続けるフォーマットは決して文法を得られず、スキルはオーナーが要求する範囲を静かに狭めてしまう。

どのように改善されるか

すべてのショートは improve モードで終了する。references/outcomes.md の結果に対して実行をスコアリングし、RUNS.md に記録し、学んだことを LESSONS.md に書き、欠陥が2回発生したか手法が実証された場合、その変更をこのスキルに一般的な用語で、オーナーが承認する差分として提案する。Git が元に戻す手段である。

リファレンス

  • references/outcomes.md:スキルが生成すべきもの、数値での評価方法、それを改善するループ
  • references/render-routing.md:ビートごとに、コード、切り抜き、生成クリップ、エンジントラックの間で選択する方法
  • references/voice.md:声、キャスティング、オーディション、ピジン語と名前、選ばれたテイクの配置
  • references/stills-and-clips.md:静止画とクリップの生成、アイデンティティを保持するプロンプト、リロール、価格
  • references/mouths.md:生成クリップに mouth_sync を使用して口を再描画する方法(ショットごとの設定を含む)
  • references/facts.md:画面上で事実として述べられるすべてのための事実ゲート
  • references/effects.md:ビートが持つことができるジョブ、各ジョブを提供するエフェクト、ショートがデモリールにならないようにする抑制ルール
  • references/qa.md:ゲート間のチェック、および各チェックが過去に何を捕捉したか
  • references/formats/:実証済みフォーマットごとに1ファイル

関連スキル

  • make-short、vidtsx-2d-generator:コード描画解説トラックとそのクラッシュルール。レンダリングパスとして使用される。
  • make-vox:コラージュトラック
  • make-ai-short:生成トラック。このスキルはそのクリップ規律を引き継ぐ。
  • suggest-sfx:サウンドキューオーディション。サウンドモードから呼び出される。
  • os-writing(Personal OS):投稿用のフックとキャプション。フィニッシュモードから呼び出される。
  • os-skillify(Personal OS):実証ラン後に新しいフォーマットリファレンスを作成する。

Individual skills in this repo

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

gbax316/make-ai-short

Build a GENERATIVE-pixels vertical short (1080×1920, ~35-40s) end-to-end — a recurring locked character animated by a fal video model (Seedance 1.5 Pro default) under a philosophical/story VO, composited in Remotion with word-synced captions, SFX audition, seamless frame-0==last-frame loop. Use when the user wants to "make an AI video short", "make an ai short", "make a blue-man video", or any short where the pixels come from a VIDEO MODEL — not TSX animation (that is make-short) and not layered collage (that is make-vox). Defers model choice re-litigating to ai-shorts/IDEAS.md, TSX crash rules to vidtsx-2d-generator, SFX taste to suggest-sfx + brand §7. For a NEW short (writers' room, dialogue skits, documentaries, mixed render paths), start with shorts-director, which calls this track as an engine.

gbax316/vidtsx-2d-generator

Generate production-ready 2D TSX video files for VidTSX (Remotion-based) from a shot, scene, or video description. Use whenever the user wants to create or generate a VidTSX video, a 2D TSX shot or scene, an animated clip, title card, or rendered motion graphic — including when they describe a visual animation they want built, or say "make a shot", "build this scene", "generate the TSX", or "turn this into a video". Covers the mandatory file structure and composition config, dimension presets (horizontal/vertical/square), six style presets (minimalist, memphis, neo-brutalism, glassmorphism, neon, corporate), and the hard rules that keep renders from crashing, covering frame-based animation only (no useState/useEffect/setTimeout), strictly monotonic interpolate ranges, Easing.bezier not wrapper syntax, and the chroma-js and @remotion/paths import gotchas. Not for 3D/three.js compositions, general React work, or editing video files.

関連スキル