Communitygithub.com

IGNOVA-SYSTEMS-INTEGRATION/KONTRX:Remotion 動画生成スキル

Remotion (React/TypeScript で動画を生成し MP4 にレンダリング) に関するベストプラクティスとドメイン知識。Remotion コードの記述・編集時に使用します。

KONTRX:Remotion 動画生成スキル とは?

このスキルは、Remotion (React/TypeScript でビデオをプログラム的に生成するライブラリ) を使用する際の包括的なベストプラクティスとドメイン知識を提供します。プロジェクトのスキャフォールディングから、`useCurrentFrame()` によるフレームベースのアニメーション、`interpolate()` や `spring()` を用いたイージング、`<Sequence>` を使ったシーン構成とトランジション、キャプション・字幕、音声・GIF・Lottie・3D コンテンツ、チャート、視覚効果、`calculateMetadata()` による動的な尺・解像度の設定、そしてレンダリングまでの全工程をカバーします。CSS トランジションや Tailwind アニメーションクラスは使用禁止など、Remotion 固有の制約にも対応します。このスキルは、Remotion API を呼び出す前に参照すべきガイドであり、コンポーネントと props の変化(例: `@remotion/media`)にも対応します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IGNOVA-SYSTEMS-INTEGRATION/KONTRX/tree/HEAD/AGENT/skills/remotion

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

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

プレビュー

スキル README より

ドキュメント

使用するタイミング

このスキルは、Remotion コードを扱う際にドメイン固有の知識を得るために使用します。

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

空のフォルダや既存の Remotion プロジェクトがないワークスペースで、以下のコマンドを使ってプロジェクトをスキャフォールディングします。

npx create-video@latest --yes --blank --no-tailwind my-video

my-video を適切なプロジェクト名に置き換えてください。

ビデオのデザイン

ビジュアルシーン、レイアウト、プロモーション、モーショングラフィックス、テキスト主体のビデオをデザインする前に、rules/video-layout.md をロードして、ビデオファーストのレイアウトとテキストサイジングのガイダンスを参照してください。

プロパティのアニメーションには useCurrentFrame() と interpolate() を使用します。物理ベースのモーションが明示的に必要な場合を除き、spring() よりも interpolate() を優先します。Easing.bezier() を使ってタイミングをカスタマイズし、跳ねるような動きやオーバーシュートする動きも実現できます。

Remotion Studio で編集可能なアニメーションにするには、interpolate() の呼び出しを style プロパティ内にインラインで配置し、transform 文字列を合成する代わりに個別の CSS 変換プロパティ(scale、translate、rotate)を使用します。

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

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

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

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

以下を推奨します:

style={{
  scale: interpolate(frame, [0, 100], [0, 1]),
  translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
  rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}

以下は避けてください:

const scale = interpolate(frame, [0, 100], [0, 1]);

style={{
  transform: `scale(${scale})`,
}}

CSS トランジションやアニメーションは使用禁止です。正しくレンダリングされません。 Tailwind のアニメーションクラス名は使用禁止です。正しくレンダリングされません。

アセットはプロジェクトルートの public/ フォルダに配置します。

staticFile() を使って public/ フォルダ内のファイルを参照します。

画像は <Img> コンポーネントを使用して追加します:

import { Img, staticFile } from "remotion";

export const MyComposition = () => {
  return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};

ビデオは @remotion/media の <Video> コンポーネントを使用して追加します:

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

export const MyComposition = () => {
  return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};

音声は @remotion/media の <Audio> コンポーネントを使用して追加します:

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

export const MyComposition = () => {
  return <Audio src={staticFile("audio.mp3")} />;
};

アセットはリモート URL としても参照できます:

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

export const MyComposition = () => {
  return <Video src="https://remotion.media/video.mp4" />
};

コンテンツを遅延させるには、<Sequence> でラップし from を使用します。 要素の期間を制限するには、<Sequence> の durationInFrames を使用します。 <Sequence> はデフォルトで絶対フィルになります。インラインコンテンツの場合は、layout="none" を使用します。

import { Sequence } from "remotion";

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

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

  return <div style={{ opacity }}>Title</div>;
};

export const Subtitle = () => {
  return <div>Subtitle</div>;
};

const Main = () => {
  const {fps} = useVideoConfig();

  return (
    <AbsoluteFill>
      <Sequence>
        <Background />
      </Sequence>
      <Sequence from={1 * fps} durationInFrames={2 * fps} layout="none">
        <Title />
      </Sequence>
      <Sequence from={2 * fps} durationInFrames={2 * fps} layout="none">
        <Subtitle />
      </Sequence>
    </AbsoluteFill>
  );
}

ビデオの幅、高さ、fps、および尺は src/Root.tsx で定義します:

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

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      durationInFrames={100}
      fps={30}
      width={1080}
      height={1080}
    />
  );
};

メタデータは動的に計算することもできます:

import { Composition, CalculateMetadataFunction } from "remotion";
import { MyComposition, MyCompositionProps } from "./MyComposition";

const calculateMetadata: CalculateMetadataFunction<
  MyCompositionProps
> = async ({ props, abortSignal }) => {
  const data = await fetch(`https://api.example.com/video/${props.videoId}`, {
    signal: abortSignal,
  }).then((res) => res.json());

  return {
    durationInFrames: Math.ceil(data.duration * 30),
    props: {
      ...props,
      videoUrl: data.url,
    },
    width: 1080,
    height: 1080,
  };
};

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      fps={30}
      width={1080}
      height={1080}
      defaultProps={{ videoId: "abc123" }}
      calculateMetadata={calculateMetadata}
    />
  );
};

プレビューの開始

Remotion Studio を起動してビデオをプレビューするには:

npx remotion studio

オプション:1フレームレンダリングチェック

CLI を使って1フレームだけレンダリングし、レイアウト、色、タイミングなどを簡単にチェックできます。 些細な編集、純粋なリファクタリング、または Studio や以前のレンダリングで十分な確信が得られている場合はスキップしてください。

npx remotion still [composition-id] --scale=0.25 --frame=30

30fps の場合、--frame=30 は1秒のマークです(--frame は0ベース)。

キャプション

キャプションや字幕を扱う場合は、./rules/subtitles.md ファイルをロードして詳細を確認してください。

FFmpeg の使用

ビデオのトリミングや無音検出など、一部のビデオ操作では FFmpeg を使用する必要があります。./rules/ffmpeg.md ファイルをロードして詳細を確認してください。

無音検出

ビデオまたはオーディオファイルから無音部分を検出してトリミングする必要がある場合は、./rules/silence-detection.md ファイルをロードしてください。

音声の可視化

音声を可視化(スペクトラムバー、波形、低音反応エフェクト)する必要がある場合は、./rules/audio-visualization.md ファイルをロードして詳細を確認してください。

効果音

効果音を使用する必要がある場合は、./rules/sfx.md ファイルをロードして詳細を確認してください。

視覚効果とピクセルエフェクト

視覚効果を作成する場合は、優先順位:1. 通常の Remotion/HTML/CSS/SVG/フィルター/ブレンド/マスクアニメーション、2. rules/effects.md にリストされたエフェクト(<HtmlInCanvas> を介してレンダリングされる HTML に対するものを含む)、3. ユーザーが再利用可能/プロジェクト固有のエフェクトを要求した場合の rules/effects.md によるカスタム createEffect()、4. どのエフェクトも合わない場合に限り、rules/html-in-canvas.md によるカスタム <HtmlInCanvas onPaint>。

ライトリークオーバーレイについては、rules/light-leaks.md を参照してください。ドキュメント:https://www.remotion.dev/docs/effects

利用可能なエフェクト:brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), linearGradient(), linearGradientTint(), thermalVision(), blur(), linearProgressiveBlur(), radialProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), venetianBlinds(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), paper(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst().

3D コンテンツ

Three.js と React Three Fiber を使用した Remotion での 3D コンテンツについては、rules/3d.md を参照してください。

高度な音声

トリミング、音量、速度、ピッチなどの高度な音声機能については、rules/audio.md を参照してください。

動的な尺、寸法、データ

コンポジションの尺、寸法、props を動的に設定するには、rules/calculate-metadata.md を参照してください。

高度なコンポジション

スチル、フォルダ、デフォルト props の定義方法、およびコンポジションのネスト方法については、rules/compositions.md を参照してください。

Google Fonts

Remotion でフォントを読み込む推奨方法です。Google Fonts の読み込み方法については、rules/google-fonts.md を参照してください。

ローカルフォント

ローカルフォントの読み込み方法については、rules/local-fonts.md を参照してください。

音声の長さの取得

Mediabunny を使用して音声ファイルの長さ(秒)を取得する方法については、rules/get-audio-duration.md を参照してください。

ビデオの寸法の取得

Mediabunny を使用してビデオファイルの幅と高さを取得する方法については、rules/get-video-dimensions.md を参照してください。

ビデオの長さの取得

Mediabunny を使用してビデオファイルの長さ(秒)を取得する方法については、rules/get-video-duration.md を参照してください。

GIF

Remotion のタイムラインに同期して GIF を表示する方法については、rules/gifs.md を参照してください。

高度な画像

画像のサイズと位置の設定、動的な画像パス、画像の寸法の取得については、rules/images.md を参照してください。

Lottie アニメーション

Remotion に Lottie アニメーションを埋め込む方法については、rules/lottie.md を参照してください。

DOM ノードの測定

Remotion で DOM 要素の寸法を測定する方法については、rules/measuring-dom-nodes.md を参照してください。

テキストの測定

テキストの寸法の測定、コンテナへのテキストの適合、オーバーフローの確認については、rules/measuring-text.md を参照してください。

高度なシーケンス

遅延、トリミング、アイテムの期間制限など、より高度なシーケンスパターンについては、rules/sequencing.md を参照してください。

TailwindCSS

Remotion で TailwindCSS を使用する方法については、rules/tailwind.md を参照してください。

テキストアニメーション

タイポグラフィとテキストアニメーションパターンについては、rules/text-animations.md を参照してください。

高度なタイミング

interpolate とベジェイージング、およびスプリングを使った高度なタイミングについては、rules/timing.md を参照してください。

トランジション

シーントランジションパターンについては、rules/transitions.md を参照してください。

透明ビデオ

透明度を持つビデオをレンダリングする方法については、rules/transparent-videos.md を参照してください。

トリミング

アニメーションの先頭や末尾をカットするトリミングパターンについては、rules/trimming.md を参照してください。

高度なビデオ

ビデオの埋め込みに関する高度な知識(トリミング、音量、速度、ループ、ピッチ)については、rules/videos.md を参照してください。

パラメータ化されたビデオ

Zod スキーマを追加してコンポジションをパラメータ化可能にする方法については、rules/parameters.md を参照してください。

地図

簡易的な地図(フライオーバーが少ない)には、静的マップ画像の使用を検討してください。 アニメーションルートやフライオーバーがある複雑な地図については、地図ルールをロードしてください:rules/maplibre.md

ナレーション

ElevenLabs TTS を使用して AI 生成のナレーションを Remotion コンポジションに追加する方法については、rules/voiceover.md を参照してください。

関連スキル