Communitygithub.com

joyehuang/skills

構造化されたビデオスクリプトを、Reactコンポーネント、オーディオ、レンダリングを備えた本番対応のRemotionプロジェクトに変換します。

skills とは?

このスキルは、構造化されたビデオスクリプト(script.json)を、すぐに実行可能なRemotionプロジェクトに変換するための包括的なワークフローを提供します。主にClaude CodeなどのAIエージェント向けに設計されており、Reactコンポーネントの生成、TTSオーディオ統合、字幕生成、ビデオレンダリングを自動化します。スクリプトから高品質なビデオコンテンツを生成したいコンテンツクリエイターやデベロッパーに特に有用です。6種類のシーンタイプ(フック、テキスト表示、数値比較、3カラム、ケーススタディ、CTA)に対応し、各シーンに特化したテンプレートとアニメーションを提供します。また、Remotionのspring()物理アニメーションエンジンを使用し、レスポンシブテキスト処理やスマートな字幕分割機能を備えています。Google Gemini APIを使用したTTSオーディオ生成もオプションでサポートしており、最終的なビデオはMP4形式でレンダリングされます。

対応✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/joyehuang/skills/tree/HEAD/script-to-remotion

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

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

ドキュメント

スクリプトから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コンポーネントを生成します

フロー:

  1. script.jsonを読み取る
  2. remotion-best-practicesスキルを参照する
  3. シーンタイプごとに対応するコンポーネントを生成する
  4. springアニメーションを使用する(CSSアニメーションは不使用)
  5. fitText/measureTextを使用してテキストサイズを処理する

ルールファイル:rules/component-generation.md シーンタイプガイド:rules/scene-types/*.md(6ファイル)

フェーズ2:プロジェクトアセンブリ(15~20分)

完全なRemotionプロジェクト構造を作成します

フロー:

  1. プロジェクトディレクトリ構造を作成する
  2. package.json、tsconfig.json、remotion.config.tsをコピーする
  3. Root.tsxメインコンポーネントを作成する
  4. 共有コンポーネント(NeonBackground、Subtitleなど)をコピーする
  5. テーマファイル(theme.ts)をコピーする
  6. 依存関係をインストールする

ルールファイル:rules/project-assembly.md

フェーズ3:TTSオーディオ生成(オプション、10~15分)

Google Gemini APIを使用してTTSオーディオを生成します

フロー:

  1. 独立したtts-generator.jsスクリプトを作成する
  2. 各シーンに対してオーディオファイルを生成する
  3. 1.25倍速を適用する
  4. 字幕セグメントデータを生成する
  5. public/audio/ディレクトリに保存する

ルールファイル:rules/tts-integration.md、rules/subtitle-generation.md

フェーズ4:プレビューとレンダリング(5~10分)

プレビューを起動しビデオをレンダリングします

フロー:

  1. Remotionプレビューサーバーを起動する(pnpm start)
  2. ブラウザで結果を確認する
  3. 最終ビデオをレンダリングする(pnpm build)
  4. 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種類のシーンタイプ対応

各シーンタイプには専用のテンプレートとアニメーションがあります:

シーンタイプ時間用途主な特徴
hook5~8秒オープニングフックタイプライター効果、バウンスアニメーション
textDisplay15~20秒コア情報の表示fitText自動調整、スライドインアニメーション
numberComparison12~18秒データ比較数字アニメーション、前後比較レイアウト
threeColumns15~20秒3カラム比較ずらし表示、Seriesシーケンス
caseStudy20~30秒ケースストーリーTransitionSeries、前後トランジション
cta8~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 - 必ず参照:コンポーネント品質を確保

関連スキル