スクリプトからRemotionへ
構造化されたビデオスクリプトを実行可能なRemotionプロジェクトに変換します。Reactコンポーネントの生成、TTSオーディオ統合、字幕生成、ビデオレンダリングを含みます。
使用シナリオ
以下の場合にこのスキルを使用します:
- script.jsonをRemotionビデオプロジェクトに変換する
- remotion-best-practicesに準拠したReactコンポーネントを生成する
- オプションでTTSオーディオを生成する(Google Gemini APIを使用)
- スマートに分割された字幕を自動生成する
- 最終ビデオ(MP4形式)をレンダリングする
使用しない場合:
- 記事から直接スクリプトを生成する場合(
article-to-scriptスキルを使用) - 既存のビデオを編集またはクリップする場合
- インタラクティブなビデオコンテンツを作成する場合
前提条件
必須
- script.json -
article-to-scriptスキルの出力 - Node.js - バージョン18以上、およびpnpmパッケージマネージャー
- remotion-best-practicesスキル - コンポーネントの品質を確保するために参照する必要があります
オプション
- Google Gemini API Key - TTSオーディオ生成用
- 背景音楽(BGM) - 必要に応じてBGMファイル
ワークフロー
このスキルは4フェーズのワークフローに従います:
フェーズ1:コンポーネント生成(30~45分)
各シーンに対してReactコンポーネントを生成します
フロー:
- script.jsonを読み取る
- remotion-best-practicesスキルを参照する
- シーンタイプごとに対応するコンポーネントを生成する
- springアニメーションを使用する(CSSアニメーションは不使用)
- fitText/measureTextを使用してテキストサイズを処理する
ルールファイル:rules/component-generation.md
シーンタイプガイド:rules/scene-types/*.md(6ファイル)
フェーズ2:プロジェクトアセンブリ(15~20分)
完全なRemotionプロジェクト構造を作成します
フロー:
- プロジェクトディレクトリ構造を作成する
- package.json、tsconfig.json、remotion.config.tsをコピーする
- Root.tsxメインコンポーネントを作成する
- 共有コンポーネント(NeonBackground、Subtitleなど)をコピーする
- テーマファイル(theme.ts)をコピーする
- 依存関係をインストールする
ルールファイル:rules/project-assembly.md
フェーズ3:TTSオーディオ生成(オプション、10~15分)
Google Gemini APIを使用してTTSオーディオを生成します
フロー:
- 独立したtts-generator.jsスクリプトを作成する
- 各シーンに対してオーディオファイルを生成する
- 1.25倍速を適用する
- 字幕セグメントデータを生成する
- public/audio/ディレクトリに保存する
ルールファイル:rules/tts-integration.md、rules/subtitle-generation.md
フェーズ4:プレビューとレンダリング(5~10分)
プレビューを起動しビデオをレンダリングします
フロー:
- Remotionプレビューサーバーを起動する(
pnpm start) - ブラウザで結果を確認する
- 最終ビデオをレンダリングする(
pnpm build) - video.mp4を出力する
ルールファイル:rules/render-configuration.md
クイックスタート
# 1. script.jsonを準備する
# article-to-scriptで生成済みと仮定
# 2. remotion-best-practicesを参照する
Read .claude/skills/remotion-best-practices/skill.md
# 3. script-to-remotionのルールを参照する
Read .claude/skills/script-to-remotion/rules/component-generation.md
Read .claude/skills/script-to-remotion/rules/scene-types/*.md
# 4. コンポーネントを生成する(各シーンに対して)
# シーンタイプに応じて適切なテンプレートとルールを選択してコードを生成
# 5. プロジェクトをアセンブルする
Read .claude/skills/script-to-remotion/rules/project-assembly.md
# 説明に従って完全なプロジェクト構造を作成
# 6. オプション:TTSを生成する
Read .claude/skills/script-to-remotion/rules/tts-integration.md
# tts-generator.jsを作成して実行
# 7. 依存関係をインストールする
cd video-output-<timestamp>
pnpm install
# 8. プレビュー
pnpm start
# ブラウザで http://localhost:3000 にアクセス
# 9. レンダリング
pnpm build
# out/video.mp4 に出力
コア機能
6種類のシーンタイプ対応
各シーンタイプには専用のテンプレートとアニメーションがあります:
| シーンタイプ | 時間 | 用途 | 主な特徴 |
|---|---|---|---|
| hook | 5~8秒 | オープニングフック | タイプライター効果、バウンスアニメーション |
| textDisplay | 15~20秒 | コア情報の表示 | fitText自動調整、スライドインアニメーション |
| numberComparison | 12~18秒 | データ比較 | 数字アニメーション、前後比較レイアウト |
| threeColumns | 15~20秒 | 3カラム比較 | ずらし表示、Seriesシーケンス |
| caseStudy | 20~30秒 | ケースストーリー | TransitionSeries、前後トランジション |
| cta | 8~12秒 | 行動喚起 | マルチステップ表示、強調アニメーション |
Spring物理アニメーション
すべてのアニメーションはRemotionのspring()物理エンジンを使用します:
const scale = spring({
frame,
fps,
config: { damping: 12, stiffness: 100 }
});
CSSアニメーションの使用禁止(remotion-best-practices違反)
レスポンシブテキスト
@remotion/layout-utilsを使用してテキストが適切に収まるようにします:
import { fitText, measureText } from '@remotion/layout-utils';
const fittedText = fitText({
text: narration,
withinWidth: 1600,
fontFamily: 'Inter',
fontSize: 80
});
スマート字幕分割
長いナレーションを読みやすい字幕に自動分割します:
- 句読点で自然に区切る
- 各セグメント3~8秒
- フェードイン/アウト効果(0.2秒)
- オーディオとの完全同期
ルールファイル
すべてのワークフロールールはrules/ディレクトリに文書化されています:
コアルール:
component-generation.md- Reactコンポーネント生成ガイドproject-assembly.md- プロジェクト構造と設定render-configuration.md- Remotionレンダリング設定troubleshooting.md- 一般的な問題の解決
シーンタイプガイド(6つ):
scene-types/hook-scene.md- オープニングフックシーンscene-types/text-display-scene.md- テキスト表示シーンscene-types/number-comparison-scene.md- 数値比較シーンscene-types/three-columns-scene.md- 3カラムシーンscene-types/case-study-scene.md- ケースストーリーシーンscene-types/cta-scene.md- CTAシーン
オーディオと字幕:
tts-integration.md- TTSオーディオ生成(オプション)subtitle-generation.md- 字幕分割アルゴリズム
テンプレートファイル
即使用可能なコードテンプレートはtemplates/ディレクトリにあります:
設定ファイル:
package.json.template- プロジェクト依存関係tsconfig.json.template- TypeScript設定remotion.config.ts.template- Remotion設定theme.ts- ネオンガラスモーフィズムテーマ
共有コンポーネント:
components/NeonBackground.tsx- 動的グラデーション背景components/SceneAudio.tsx- オーディオプレーヤーcomponents/Subtitle.tsx- 字幕コンポーネント
その他:
Root.tsx.template- メインコンポーネントテンプレートtts-generator.js.template- TTS生成スクリプト
例
examples/script-input.json- サンプル入力スクリプトexamples/Hook-scene-example.tsx- 完全なHookシーンコンポーネントexamples/complete-project/- 完全なプロジェクトリファレンス
Bashコマンド
すべてのCLI操作はcommands/bash-commands.mdに文書化されています:
- プロジェクトセットアップコマンド
- 依存関係のインストール
- TTS生成(オプション)
- プレビューとレンダリング
- エラーハンドリング
品質保証
remotion-best-practicesに従う必要があります
重要なルール:
- ✅ すべてのアニメーションにspring()を使用する
- ✅ テキスト処理にfitText/measureTextを使用する
- ✅ コンポーネントは純粋関数にする(副作用なし)
- ✅ useCurrentFrame()とuseVideoConfig()を正しく使用する
- ❌ CSS animationsやtransitionsを使用しない
- ❌ useState/useEffectを使用しない
- ❌ 外部API呼び出しを行わない
コンポーネント品質基準
生成される各コンポーネントは以下を満たす必要があります:
- TypeScriptでエラーなくコンパイルされる
- 正しい型がエクスポートされる(シーンコンポーネント)
- PropsにstartFrame、durationFrames、sceneを含む
- アニメーションがスムーズである(60fps)
- テキストがはっきり読める
- 色のコントラストが十分である
トラブルシューティング
一般的な問題と解決策はrules/troubleshooting.mdにあります:
- TypeScriptコンパイルエラー
- アニメーションのカクつき
- テキストのはみ出し
- オーディオ同期の問題
- レンダリングの失敗
バージョン履歴
- v3.0.0(2025-01):純粋なドキュメントスキル、テンプレート駆動
- v2.1.0(2024-12):CLI駆動のフェーズ4~8実装
- v1.0.0(2024-11):初期モノリシックスキル
サポート
問題が発生した場合:
rules/troubleshooting.mdで一般的な問題を確認するexamples/の実装例を参照するremotion-best-practicesスキルを確認する- Remotion公式ドキュメントを参照する
関連スキル
- article-to-script - 上流:script.jsonを生成
- remotion-best-practices - 必ず参照:コンポーネント品質を確保