remotion-production

Remotion の本番ワークフロー

このスキルは、Remotion 自身のスキルでは扱わない、メディアの取得をカバーします。5 つの MCP サーバーを連携させて、ナレーション、音楽、効果音、映像素材、画像、クリップを生成し、それらを Remotion のコンポジションに組み込みます。

公式スキルとの連携

このプラグインは各プロバイダー独自の Agent Skills を基盤としており、Remotion 動画の制作に特有の内容だけを扱います。

プロバイダー	公式スキル	インストール
Remotion	remotion-best-practices + サブスキル	npx skills add remotion-dev/skills
ElevenLabs	text-to-speech、sound-effects、music、speech-to-text、voice-isolator、voice-changer	npx skills add elevenlabs/skills
Replicate	find-models、run-models、compare-models、prompt-images、prompt-videos	npx skills add replicate/skills

TwelveLabs には Agent Skills がありません。エージェント向けのドキュメントは https://docs.twelvelabs.io（および llms.txt）にあります。

Remotion は公式の Agent Skills（remotion-best-practices とそのサブスキルである remotion-create、remotion-markup、remotion-studio、remotion-render、remotion-captions、remotion-multimedia、…）を管理しています。これらは Remotion API の信頼できる情報源であり、Remotion のリリースごとに更新されます。見つからない場合は、先にインストールしてください。npx skills add remotion-dev/skills を実行するか、setup スキルを実行します。

両方が読み込まれている場合は、次のように作業を分担してください。

項目	従うもの
ナレーション、効果音、音楽	ElevenLabs の公式スキル：プロジェクト内の小さな SDK スクリプトを使い、このスキルの命名規則で public/ に書き込みます。デフォルト：eleven_v4（音声）、music_v2_5（音楽）。
画像と AI クリップ	このスキル：remotion-media 経由の KIE。特定のモデルを使う場合や KIE が失敗した場合は、（Replicate の公式スキルとともに）Replicate を使用します
ストック映像、映像分析、AI によるレビュー	このスキル：Pexels と TwelveLabs の MCP ツール
Remotion のマークアップ：コンポーネント、インポート、タイミング用 props、アニメーション、エフェクト、トランジション、フォント	公式の remotion-markup
プロジェクトのひな形作成	公式の remotion-create
プレビュー	公式の remotion-best-practices / remotion-studio：シーンを作り始める前に、プロジェクトが動作したらすぐ Studio を起動し、開いたままにします
レンダリング	公式の remotion-render：ユーザーが MP4 を求めた場合、または review-video の実行時に限ります
字幕：単語単位の文字起こしと表示	公式の remotion-captions（このスキルでは TikTok 風プリセットとショート動画向けの配置のみを追加します）
メディアの長さの測定	calculateMetadata 内で使用する 公式の remotion-multimedia（Mediabunny）
ここで扱っていない内容	推測せず、公式の remotion-docs スキルを使って最新のドキュメントを確認してください

ここにあるコードスニペットが公式スキルと食い違う場合は、公式スキルを優先してください。

プロバイダーと MCP ツール

ElevenLabs（音声、効果音、音楽：デフォルト）

• 公式の ElevenLabs スキル（SDK スクリプト、ELEVENLABS_API_KEY）を使って生成します。Eleven Music は有料プランで商用利用が許可されています。
• 非推奨の代替手段： ElevenLabs MCP サーバー（elevenlabs-mcp 0.12.2。上流でアーカイブ済み）は、手軽な対話型作業向けに、あと 1 リリースだけ提供されます。利用できるツールは text_to_speech、text_to_sound_effects、compose_music、voice_clone、search_voices、search_voice_library、isolate_audio、speech_to_text です。読み書きできるのは public/ 内のみです。output_directory にはプロジェクトの public/ を指定してください。

remotion-media（KIE 経由：画像と動画クリップ）

• generate_image：AI 画像（Nano Banana Pro）
• generate_video_from_text：プロンプトから AI 動画クリップを生成（Veo 3.1）
• generate_video_from_image：1 枚の画像をアニメーション化するか、2 枚の画像間をトランジションします。image_urls には公開 URL を指定する必要があります。
• generate_speech、generate_music、generate_sound_effect：ドラフト専用です。 Suno および KIE が再販するその他のモデルは、KIE を通じた所有者からのライセンスを受けていません。ドラフトや内部作業には KIE のオーディオを使用し、商用利用する最終版のオーディオは ElevenLabs で生成してください。
• list_assets：Airtable のアセットライブラリを参照します（AIRTABLE_API_KEY が必要です）
• 字幕ツールは使用しないでください。キャプションは公式の Remotion の手順で作成します。
• KIE の Veo は、Google が廃止を予定しているプレビュー版に依存しています。動画クリップの呼び出しに失敗した場合は、Replicate に切り替えてください。

これらのツールはファイルパスを返しますが、長さは返しません。公式の remotion-multimedia スキルに従って長さを測定してください。

TwelveLabs（動画の理解と AI レビュー）

• create-asset（ローカルファイルをアップロード）→ modelName: "pegasus1.5" と JSON レスポンススキーマを指定して sync-analyse-video または async-analyse-video を実行 → 完了後に delete-asset
• search で見つかるのは、インデックス化されたライブラリ内の場面（「…の場面」）だけです。動画の分析はできません。

Pexels（ストック動画素材）

• pexels_search_videos、pexels_search_photos、pexels_popular_videos、pexels_curated_photos、pexels_get_video、pexels_get_photo、コレクション
• ダウンロードツールはありません。pexels_get_video（または検索結果）からファイル URL を取得し、curl で public/footage/ に保存してください。
• Pexels ではクレジット表記は不要ですが、表記することが推奨されています。

Replicate（任意、特定のモデル向け）

• ローカルの replicate-mcp と REPLICATE_API_TOKEN を使用します：search_models、get_models、list_models_examples、create_models_predictions / create_predictions、get_predictions、download_files
• 公式の Replicate スキルに従ってください。モデルを検索し、呼び出す前に入力スキーマを確認してください。日付入りの候補一覧については rules/replicate-models.md を参照してください。

アセットの規則

• remotion-media ツールは、エージェントを起動したディレクトリ内の public/<output_name>.<ext> に書き込みます。 そのため、エージェントは Remotion プロジェクトのルートから起動する必要があります。サブフォルダーには書き込めないため、名前に種類を含めてください：vo-scene1、music-bg、sfx-whoosh、img-hero、clip-city-aerial。
• 自分でダウンロードしたファイル（Pexels、Replicate の出力）はサブフォルダーに保存します：mkdir -p public/footage public/images を実行してから、curl -L -o public/footage/<name>.mp4 <url> を実行してください。
• すべてのファイルを、public/ からの正確な相対パスで staticFile() を使って参照してください。例：staticFile("vo-scene1.mp3") または staticFile("footage/city.mp4")。

ルール

タスクに該当するルールを確認してください。

• rules/production-pipeline.md：コンセプトからプレビューまでの、MCP ステップの一連の順序
• rules/audio-integration.md：ナレーション、音楽、効果音の重ね方とダッキング
• rules/voiceover-sync.md：generate_speech によるシーンごとのナレーションと、calculateMetadata を使ったタイミング調整
• rules/music-scoring.md：音楽のプロンプト、音量レベル、シーンごとの音楽
• rules/sound-effects.md：効果音のプロンプトライブラリと、映像上のイベントに合わせたタイミング
• rules/elevenlabs-advanced.md：音声のクローン作成、音声ライブラリ、音声分離、複数の音声を使った台本
• rules/stock-footage-workflow.md：Pexels での検索、ダウンロード、クレジット表記
• rules/video-analysis.md：TwelveLabs のインデックス作成、検索、クリップ選定
• rules/image-generation.md：画像のプロンプトとプロバイダーの選択（KIE、Replicate、Pexels）
• rules/video-generation.md：クリップのプロンプト、プロバイダーの選択、画像から動画へのパイプライン
• rules/replicate-models.md：Replicate モデルカタログと、KIE より Replicate を使う場合
• rules/captions-workflow.md：公式の字幕フローに追加する、TikTok スタイルの字幕プリセット
• rules/animation-presets.md：公式のマークアップ形式によるテキストアニメーションのレシピ
• rules/data-visualization.md：アニメーション付きのグラフ、ダッシュボード、カウンター
• rules/visual-effects.md：公式エフェクトに加え、レターボックスとグリッチを使う場合
• rules/ci-rendering.md：レンダリングを自動化する GitHub Actions のワークフロー
• rules/asset-management.md：命名規則、public/ の構成、staticFile() に関するよくある間違い

3D、トランジション、ライトリーク、Lottie、フォント、その他の Remotion API については、公式の remotion-markup スキルを直接使用してください。

重要な原則

1. タイミングは音声に合わせます。 まずシーンごとにナレーションを生成し、各ファイルの長さを calculateMetadata で測定してから、それに基づいてシーンとコンポジションのサイズを決めます。フレーム数で表す長さは整数にし、Math.ceil を使用してください。
2. まずプレビューします。 プロジェクトが動作したらすぐに Studio を起動し、ユーザーがアセットの配置を確認しながら方向性を調整できるようにします。レンダリングは依頼された場合、または review-video の場合にのみ行ってください。
3. ツールで生成し、公式スキルでマークアップを記述します。 MCP ツールでファイルを作成し、公式スキルに従って配置方法（@remotion/media の <Audio> と <Video>、タイミングプロパティ、エフェクト）を決めます。
4. ユーザーの変更を維持します。 ターン間にユーザーがコードを編集している場合、その編集内容を保持してください。