Communitygithub.com

thevibethinker/n5os-ode

React と Remotion を使ってプログラムで動画を作成します。プロジェクトの雛形作成、コンポジションの作成、MP4 のレンダリングが可能です。

n5os-ode とは?

このスキルは、React ベースの動画生成フレームワークである Remotion を使用して、プログラムによる動画作成を実現します。開発者は、React コンポーネントとして動画の各フレームを記述し、フレームベースのアニメーション、シーケンス、トランジションを組み合わせることで、データドリブンな動画(チャート、統計、パーソナライズ動画)や、ソーシャルメディア向けコンテンツ、製品説明動画などを精密に制御できます。`python3 Skills/remotion/scripts/remotion_cli.py` コマンドでプロジェクトの新規作成、プレビュー(Studio)、レンダリング(MP4)を実行でき、Zo 環境では `/zo/ask` を使ってバッチレンダリングも可能です。CSS アニメーションは禁止で、すべてのモーションは `useCurrentFrame()` によるフレームベースで行います。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thevibethinker/n5os-ode/tree/HEAD/Skills/remotion

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

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

ドキュメント

使用するタイミング

このスキルは以下の場合に使用します:

  • コードからプログラムで動画を作成する場合(生成AI動画ではありません)
  • データ駆動型の動画コンテンツ(チャート、統計、パーソナライズ動画)を構築する場合
  • テンプレートとデータからバッチ動画を生成する場合
  • アニメーションを使用したソーシャルコンテンツ(TikTok、Reels、Shorts)を作成する場合
  • 正確な制御が必要な製品デモや説明動画を構築する場合

クイックスタート

1. 新しいプロジェクトを作成

python3 Skills/remotion/scripts/remotion_cli.py new my-video --template blank
cd Sites/my-video

2. コンポジションを記述

src/Composition.tsx を編集します - これが React コンポーネントとして定義された動画です。

3. Studio でプレビュー

python3 Skills/remotion/scripts/remotion_cli.py studio my-video

4. MP4 にレンダリング

python3 Skills/remotion/scripts/remotion_cli.py render my-video --output output.mp4

コアコンセプト

コンポジション

コンポジションは動画の寸法、長さ、fps を定義します:

<Composition
  id="MyVideo"
  component={MyComponent}
  durationInFrames={300}  // 30fps で10秒
  fps={30}
  width={1920}
  height={1080}
/>

フレームベースのアニメーション

すべてのアニメーションは useCurrentFrame() を使用する必要があります。CSS アニメーションは禁止です。

const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });

シーケンス

要素の表示タイミングを指定するには <Sequence> を使用します:

<Sequence from={30} durationInFrames={60}>
  <Title />
</Sequence>

ルールリファレンス

詳細なパターンについては以下を参照してください(上流の Remotion スキルから読み込まれます):

ルール説明
references/animations.mdフレームベースアニメーションの基礎
references/timing.mdスプリング、イージング、補間曲線
references/compositions.mdコンポジション、スチル、フォルダの定義
references/sequencing.md要素のタイミングと順序付け
references/videos.md動画の埋め込み - トリミング、音量、速度
references/audio.mdオーディオ処理 - インポート、トリミング、音量
references/assets.md画像、フォント、静的ファイル
references/transitions.mdシーントランジション
references/text-animations.mdタイポグラフィアニメーションパターン
references/charts.mdデータ可視化パターン
references/display-captions.mdTikTok スタイルのキャプション

CLI コマンド

# プロジェクト管理
python3 Skills/remotion/scripts/remotion_cli.py new <name> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <name>
python3 Skills/remotion/scripts/remotion_cli.py render <name> [--composition ID] [--output path]
python3 Skills/remotion/scripts/remotion_cli.py list

# レンダリングオプション
--composition ID    # レンダリングする特定のコンポジション(デフォルト: 最初)
--output PATH       # 出力ファイルパス(デフォルト: out/video.mp4)
--fps N             # FPS の上書き
--width N           # 幅の上書き
--height N          # 高さの上書き
--codec CODEC       # h264, h265, vp8, vp9, prores(デフォルト: h264)

よく使うパターン

フェードイン/アウト

const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();

const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;

スプリングアニメーション(自然な動き)

const scale = spring({
  frame,
  fps,
  config: { damping: 200 }, // スムーズ、バウンスなし
});

要素のずらし表示

{items.map((item, i) => (
  <Sequence key={i} from={i * 10}>
    <Item data={item} />
  </Sequence>
))}

データ駆動型動画

type VideoProps = { title: string; stats: number[] };

export const DataVideo: React.FC<VideoProps> = ({ title, stats }) => {
  // プロパティに基づいてアニメーション
};

// Root.tsx 内:
<Composition
  id="DataVideo"
  component={DataVideo}
  defaultProps={{ title: "Q4 結果", stats: [10, 20, 30] }}
  // ...
/>

Zo との統合

バッチレンダリング

/zo/ask を使用して複数の動画を並行レンダリングします:

for row in data:
    # 各呼び出しで異なるプロパティでレンダリング
    await render_video(row)

出力場所

プロジェクトは一貫性のために Sites/<name>/ に配置されます(Zo のサイトシステムと連携)。 レンダリングされた動画は Sites/<name>/out/ に出力されます。

制約

  • CSS アニメーション禁止 - 正しくレンダリングされません
  • Tailwind アニメーションクラス禁止 - 同様の問題
  • フレームベースのみ - すべてのモーションは useCurrentFrame() から
  • CPU 負荷が高い - レンダリングに時間がかかります; 複雑な動画ほどレンダリング時間が長くなります
  • Node.js 必須 - Remotion は Node 環境を必要とします(Zo ではすでに利用可能)

関連スキル