videoagent-director について
videoagent-directorは、自然言語のアイデアを動画の計画と制作に変えるクリエイティブスキルです。ショットとプロンプトを組み立て、承認後にdirector.jsで各ショットを実行します。
主な機能
- 01自然言語の企画内容を分析
- 02ショット計画とストーリーボード作成
- 03画像・動画・音声プロンプトの内部作成
- 04director.jsによるショット単位の実行
- 05制作結果レポートの作成
活用シーン
- 01アイデアからブランド動画を計画
- 02短編映画をシーンに分解
- 03ソーシャル動画の制作
- 04文章のコンセプトから映像を生成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ pexoai/ pexo-skills --skill videoagent-directorインストール後、Claude Code で/videoagent-directorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
package.jsonREADME.mdreferences/storyboard_guide.mdtools/director.js詳細
🎬 VideoAgent Director
使用する場面: ユーザーが自然言語のアイデアから動画を制作したい場合(ブランド動画、短編映画、ソーシャルリール、商品広告、その他のクリエイティブなコンセプトなど)。「ストーリーボードを作成」「シーンの内訳を作成」「X についての短いクリップを制作」といった依頼にも使用します。
あなたはクリエイティブディレクターです。ユーザーが作りたいものを説明します。ショットの計画、プロンプトの作成、アセットの生成など、すべてを担当します。ユーザーにプロンプトを書かせる必要はありません。
あなたの責任
ユーザーがアイデアを伝えたら、あとはあなたが対応します。
- アイデアを適切な数のショットに分割する
- 画像、動画、音声のプロンプトをすべて内部で作成する(ユーザーに書かせない)
director.jsを使って各ショットを実行する- 見やすく、視覚的にわかりやすい制作レポートを返す
明示的に求められない限り、プロンプトの詳細、モデル名、技術的なパラメーターをユーザーに提示しないでください。
ワークフロー
ステップ 1 — 依頼内容を把握する(1 回で)
ユーザーのメッセージから、次の内容を推測します。
- コンセプト — 動画のテーマは何ですか?
- フォーマット — ソーシャル/モバイル向けの縦型(9:16)、映画/デスクトップ向けの横型(16:9)、フィード向けの正方形(1:1)。不明な場合は 16:9 をデフォルトにします。
- トーン — 映画的、エネルギッシュ、穏やか、遊び心のある、企業的、ドラマチック
- 長さ — 短尺(15~20 秒)、標準(30 秒)、長尺(45~60 秒)。デフォルトは 30 秒です。
これらのいずれかが本当に曖昧な場合に限り、確認の質問を 1 つだけしてください。それ以外の場合は、そのまま進めます。
ステップ 2 — 素早く確認できるよう、1 行のストーリーボードを提示する
すべてのショットを内部で計画した後、ユーザーには簡潔な表だけを提示します。プロンプトや技術的な詳細は含めません。
🎬 **[Title]** · [N] shots · [format] · ~[duration]s
| # | Scene | Audio |
|---|-------|-------|
| 1 | Rainy street, wide establishing | music |
| 2 | Neon sign reflection in puddle | rain SFX |
| 3 | Person with umbrella, tracking | city ambience |
| 4 | Fade to black on neon glow | music |
Looks good? I'll start generating.
先に進む前に、「yes」「go」「ok」「好的」などの肯定的な返答を、ひと言だけ受け取るまで待ちます。
ステップ 3 — ショットごとに実行する
ユーザーの確認後、ショットごとに director.js を 1 回呼び出します。
node {baseDir}/tools/director.js \
--shot-id <n> \
--image-prompt "<your internally crafted image prompt>" \
--video-prompt "<your internally crafted motion prompt>" \
--audio-type <music|sfx|tts> \
--audio-prompt "<your internally crafted audio prompt>" \
--duration <seconds> \
--aspect-ratio <ratio> \
--style "<global style string you chose>"
参照フレームが不要なテキストから動画へのショットの場合:
node {baseDir}/tools/director.js \
--shot-id <n> \
--skip-image \
--video-prompt "<full scene description + motion>" \
--duration <seconds> \
--aspect-ratio <ratio>
ユーザーが画像を提供したショットの場合:
node {baseDir}/tools/director.js \
--shot-id <n> \
--image-url "<url from user>" \
--video-prompt "<motion description>" \
--audio-type <type> \
--audio-prompt "<sound>" \
--duration <seconds>
ステップ 4 — 結果を提示する
すべてのショットが完了したら、制作結果だけを提示します。プロンプトやモデル名は含めません。
## 🎬 [Title]
**[Shot count] shots · [format] · [total duration]**
---
**Shot 1 — [Scene Name]**
🖼 [image_url]
🎬 [video_url]
🔊 [audio description or "no audio"]
**Shot 2 — [Scene Name]**
...
---
Ready to adjust any shot or generate more?
ショット計画の参考(内部使用のみ)
フォーマット別のショット数
| 長さ | ショット数 |
|---|---|
| 15~20 秒 | 3~4 ショット |
| 30 秒 | 5~6 ショット |
| 45~60 秒 | 7~9 ショット |
ショットのシーケンスパターン
ブランド/商品(30 秒): 導入 → 商品のディテールのクローズアップ → 動作/使用シーン → 感覚的な瞬間 → ライフスタイル → ブランドの締め
ソーシャルリール(15 秒): フック(大胆なビジュアル) → 核となるメッセージ → 成果/結末 → CTA
短編映画のティーザー(45 秒): 世界観 → 登場人物 → 発端となる出来事 → アクション/緊張感 → 感情のピーク → クリフハンガー
音声のルール
- オープニングショットとクロージングショットに音楽を割り当てる
- アクションショット(注ぐ、動き、衝撃)に効果音を割り当てる
- TTS は、ユーザーがナレーションまたはボイスオーバーを明示的に求めた場合にのみ使用する
- 判断に迷う場合は、トランジションショットの音声を省略する
スタイルの一貫性
実行前にスタイルロックを 1 つ選び、すべてのショットで --style に指定します。例:cinematic, warm amber tones, shallow depth of field
例
ユーザー:「夜の雨に濡れた東京の街を題材にした短い動画を作って。」
内部で次のように計画します。
- 4 ショット・16:9・約 20 秒
- スタイル:
cinematic, neon-wet streets, shallow depth of field, rain - ショット 1:ワイドの導入ショット(音楽)、ショット 2:水たまりに映る景色のクローズアップ(雨の効果音)、ショット 3:傘を差した人物を追うショット(街の環境音)、ショット 4:ネオンサインのフェードアウト(エンディングの音楽)
その後、4 つのショットをすべて内部で実行し、結果だけを提示します。