Communitygithub.com

tinh2/skills-hub-registry

Remotion(React)を使ってプログラムで動画を作成します。コンポジション、アニメーション、シーケンス、トランジション、音声・動画の埋め込み、スプリング物理、テキストアニメーション、ElevenLabs TTSによるナレーション生成、FFmpeg統合、キャプション・字幕、Three.jsによる3D、チャート、レンダリングをカバーします。公式のRemotionベストプラクティスに基づいています。

skills-hub-registry とは?

このスキルは、Reactベースの動画作成ライブラリRemotionを使用して、プログラム的に動画を構築するための包括的なガイドです。開発者はReactコンポーネントを用いて、高品質な動画コンテンツを効率的に生成でき、複雑なUIのアニメーション、シーン切り替え、音声・動画の同期処理を宣言的に記述できます。このスキルでは、Remotionのコア機能であるコンポジション、useCurrentFrame()とinterpolate()によるアニメーション、スプリング物理、シーケンスとトランジション、音声・動画の埋め込み、ElevenLabs TTSによるナレーション生成、FFmpeg統合、レンダリングオプションなどを網羅しています。公式のRemotionベストプラクティスに従い、CSSアニメーションやTailwindのアニメーションクラスを使用せず、すべてのモーションをRemotionのAPIで処理する必要性を強調しています。テキストアニメーション、Three.jsによる3D、チャート、字幕生成といった高度な機能についても言及されており、動画制作ワークフローをコードで完全に制御したい開発者にとって、実践的なリファレンスとなります。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/tinh2/skills-hub-registry/tree/HEAD/build/remotion

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

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

ドキュメント

Remotion -- React での動画作成

このスキルは、Remotion コードを扱う際に使用します。Remotion を使用すると、React コンポーネントを使ってプログラムで動画を作成できます。

プロジェクトのセットアップ

npx create-video@latest my-video
cd my-video
npm start        # ブラウザでプレビュー
npm run render   # MP4 にレンダリング

コンポジション

<Composition> は、寸法、fps、持続時間を持つレンダリング可能な動画を定義します。

import { Composition } from "remotion";
import { MyVideo } from "./MyVideo";

export const RemotionRoot = () => (
  <Composition
    id="MyVideo"
    component={MyVideo}
    durationInFrames={300}
    fps={30}
    width={1920}
    height={1080}
    defaultProps={{ title: "Hello World" } satisfies MyVideoProps}
  />
);

defaultProps の型安全性のため、props には type 宣言を使用し(interface は使用しないでください)。

サイドバーでコンポジションを整理するには <Folder> を使用します。サムネイルやOG画像などの単一フレーム出力には <Still> を使用します。

アニメーション

すべてのアニメーションでは、必ず useCurrentFrame() を使用する必要があります。CSS トランジションと Tailwind アニメーションクラスは禁止です。これらは正しくレンダリングされません。

import { useCurrentFrame, useVideoConfig, interpolate } from "remotion";

export const FadeIn = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
  });

  return <div style={{ opacity }}>Hello World!</div>;
};

スプリングアニメーション

スプリングは自然な動きを提供します。0 から 1 の間でアニメーションします。

import { spring, useCurrentFrame, useVideoConfig } from "remotion";

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

const scale = spring({ frame, fps });
// 設定あり:
const smooth = spring({ frame, fps, config: { damping: 200 } }); // バウンスなし
const snappy = spring({ frame, fps, config: { damping: 20, stiffness: 200 } });
const bouncy = spring({ frame, fps, config: { damping: 8 } });
const heavy  = spring({ frame, fps, config: { damping: 15, stiffness: 80, mass: 2 } });

delay パラメータを使用してスプリングの開始を遅らせます:

const entrance = spring({ frame, fps, delay: 20 });

補間

// クランプ付き線形補間
const opacity = interpolate(frame, [0, 100], [0, 1], {
  extrapolateRight: "clamp",
  extrapolateLeft: "clamp",
});

// マルチステップ補間
const y = interpolate(frame, [0, 30, 60, 90], [100, 0, 0, -100]);

シーケンス

Sequence

要素が表示されるタイミングを遅らせるには <Sequence> を使用します。コンポーネントをプリロードするには、常に premountFor を使用してください。

import { Sequence } from "remotion";

const { fps } = useVideoConfig();

<Sequence from={1 * fps} durationInFrames={2 * fps} premountFor={1 * fps}>
  <Title />
</Sequence>
<Sequence from={2 * fps} durationInFrames={2 * fps} premountFor={1 * fps}>
  <Subtitle />
</Sequence>

絶対配置ラッパーを防ぐには layout="none" を使用します。

Series

重なりなく順次再生するには <Series> を使用します:

import { Series } from "remotion";

<Series>
  <Series.Sequence durationInFrames={45}><Intro /></Series.Sequence>
  <Series.Sequence durationInFrames={60}><MainContent /></Series.Sequence>
  <Series.Sequence durationInFrames={30}><Outro /></Series.Sequence>
</Series>

負の offset はオーバーラップするトランジションを作成します:

<Series.Sequence offset={-15} durationInFrames={60}>
  <SceneB />
</Series.Sequence>

トランジション

npx remotion add @remotion/transitions
import { TransitionSeries, linearTiming } from "@remotion/transitions";
import { fade } from "@remotion/transitions/fade";
import { slide } from "@remotion/transitions/slide";
import { wipe } from "@remotion/transitions/wipe";

<TransitionSeries>
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneA />
  </TransitionSeries.Sequence>
  <TransitionSeries.Transition
    presentation={fade()}
    timing={linearTiming({ durationInFrames: 15 })}
  />
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneB />
  </TransitionSeries.Sequence>
</TransitionSeries>

ライトリークオーバーレイ

import { LightLeak } from "@remotion/light-leaks";

<TransitionSeries>
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneA />
  </TransitionSeries.Sequence>
  <TransitionSeries.Overlay durationInFrames={20}>
    <LightLeak />
  </TransitionSeries.Overlay>
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneB />
  </TransitionSeries.Sequence>
</TransitionSeries>

オーバーレイはトランジションまたは別のオーバーレイに隣接することはできません。

オーディオ

npx remotion add @remotion/media
import { Audio } from "@remotion/media";
import { staticFile } from "remotion";

// 基本的なオーディオ
<Audio src={staticFile("audio.mp3")} />

// トリミングあり(値はフレーム単位)
<Audio src={staticFile("audio.mp3")} trimBefore={2 * fps} trimAfter={10 * fps} />

// ボリューム制御
<Audio src={staticFile("audio.mp3")} volume={0.5} />

// 動的ボリューム(コールバックはフレームを受け取る)
<Audio src={staticFile("audio.mp3")} volume={(f) =>
  interpolate(f, [0, 30], [0, 1], { extrapolateRight: "clamp" })
} />

// 速度変更
<Audio src={staticFile("audio.mp3")} playbackRate={1.5} />

// オーディオ開始を遅らせる
<Sequence from={1 * fps}>
  <Audio src={staticFile("audio.mp3")} />
</Sequence>

複数の <Audio> コンポーネントは自動的にレイヤーされます。

動画の埋め込み

import { Video } from "@remotion/media";

// 基本的な動画
<Video src={staticFile("video.mp4")} />

// トリミングあり
<Video src={staticFile("video.mp4")} trimBefore={2 * fps} trimAfter={10 * fps} />

// 速度、ボリューム、ループ
<Video src={staticFile("video.mp4")} playbackRate={2} volume={0.5} loop />

// レンダリングパフォーマンス向上のため、OffthreadVideo を使用
import { OffthreadVideo } from "remotion";
<OffthreadVideo src={staticFile("video.mp4")} />

レンダリングパフォーマンスを向上させるために、常に <OffthreadVideo> を使用してください。プレビュー中のみ <Video> を使用します。

ElevenLabs TTS によるナレーション

シーンごとに音声を生成し、calculateMetadata を使用してコンポジションの長さを動的に調整します。

オーディオを生成する

const response = await fetch(
  `https://api.elevenlabs.io/v1/text-to-speech/${voiceId}`,
  {
    method: "POST",
    headers: {
      "xi-api-key": process.env.ELEVENLABS_API_KEY!,
      "Content-Type": "application/json",
      Accept: "audio/mpeg",
    },
    body: JSON.stringify({
      text: "Welcome to the show.",
      model_id: "eleven_multilingual_v2",
      voice_settings: { stability: 0.5, similarity_boost: 0.75, style: 0.3 },
    }),
  },
);
const audioBuffer = Buffer.from(await response.arrayBuffer());
writeFileSync(`public/voiceover/scene-01.mp3`, audioBuffer);

動的な持続時間

import { CalculateMetadataFunction, staticFile } from "remotion";

const FPS = 30;
const SCENES = ["voiceover/scene-01.mp3", "voiceover/scene-02.mp3"];

export const calculateMetadata: CalculateMetadataFunction<Props> = async () => {
  const durations = await Promise.all(
    SCENES.map((file) => getAudioDuration(staticFile(file)))
  );
  const totalFrames = durations.reduce((sum, d) => sum + Math.ceil(d * FPS), 0);
  return { durationInFrames: totalFrames };
};

アセット

ファイルを public/ に配置し、staticFile() で参照します:

import { staticFile, Img } from "remotion";

<Img src={staticFile("logo.png")} />

メディアファイルには require() や import を決して使用しないでください。常に staticFile() を使用します。

フォント

import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();

// またはローカルフォント
const { fontFamily } = loadFont({
  url: staticFile("fonts/MyFont.woff2"),
  display: "swap",
});

Remotion での FFmpeg

FFmpeg はバンドルされているため、インストールは不要です:

bunx remotion ffmpeg -i input.mp4 output.mp3
bunx remotion ffprobe input.mp4

トリミングには、FFmpeg ではなく trimBefore/trimAfter プロパティを優先して使用します。フォーマット変換や、Remotion ではネイティブにできない操作には FFmpeg を使用します。

FFmpeg でトリミングする場合、フリーズフレームを避けるために必ず再エンコードする必要があります:

bunx remotion ffmpeg -ss 00:00:05 -i public/input.mp4 -to 00:00:10 -c:v libx264 -c:a aac public/output.mp4

レンダリング

# 特定のコンポジションをレンダリング
npx remotion render MyVideo output.mp4

# 静止フレームをレンダリング
npx remotion still MyVideo --frame=100 thumbnail.png

# カスタム props を使用
npx remotion render MyVideo output.mp4 --props='{"title": "Custom"}'

# 特定のコーデック
npx remotion render MyVideo output.webm --codec=vp8

一般的なパターン

シーンベースの動画

const SCENES = [
  { component: TitleScene, duration: 90 },
  { component: ProblemScene, duration: 150 },
  { component: SolutionScene, duration: 120 },
  { component: CTAScene, duration: 90 },
];

export const MyVideo = () => {
  let offset = 0;
  return (
    <>
      {SCENES.map(({ component: Component, duration }, i) => {
        const from = offset;
        offset += duration;
        return (
          <Sequence key={i} from={from} durationInFrames={duration}>
            <Component />
          </Sequence>
        );
      })}
    </>
  );
};

背景音楽 + ナレーション

<>
  {/* 低音量で背景音楽 */}
  <Audio src={staticFile("music/bg.mp3")} volume={0.12} loop />

  {/* フル音量でシーンのナレーション */}
  <Sequence from={0} durationInFrames={scene1Frames}>
    <Audio src={staticFile("voiceover/scene-01.mp3")} volume={1} />
  </Sequence>
  <Sequence from={scene1Frames} durationInFrames={scene2Frames}>
    <Audio src={staticFile("voiceover/scene-02.mp3")} volume={1} />
  </Sequence>
</>

主要なルール

  1. CSS アニメーションは禁止 -- すべての動きは useCurrentFrame() + interpolate()/spring() で行う
  2. Tailwind アニメーションクラスは禁止 -- 正しくレンダリングされない
  3. アセットには常に staticFile() -- require() は使用しない
  4. Sequence には常に premountFor を指定する
  5. レンダリングには <OffthreadVideo> を使用する -- <video> は使わない
  6. 持続時間は秒単位で記述し、fps を乗算する
  7. defaultProps の型安全性のために satisfies キーワードを使用する

出典: remotion-dev/skills, remotion.dev

関連スキル