Communitygithub.com

echoleesong/claude-skills-plugin

Remotion(Reactを使った動画作成)のベストプラクティス

claude-skills-plugin とは?

このスキルは、Claude CodeなどのAIエージェントがRemotionプロジェクトを効率的に開発・運用するための包括的なガイドラインを提供します。Reactベースの動画フレームワークであるRemotionのプロジェクトセットアップ、アニメーション設計、アセット管理、字幕処理、音声可視化、3Dコンテンツ、フォント読み込み、トランジション、パラメータ化など、多岐にわたるトピックをカバーしています。このスキルは主にClaude Code向けに設計されており、各ルールは詳細なマークダウンファイルとして参照できるよう構造化されています。AIエージェントはこのスキルに従うことで、Remotionのベストプラクティスに準拠したコード生成、プロジェクトのセットアップ、動画プレビューの開始、単一フレームのレンダリングチェックなどを正確に実行できるようになります。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/echoleesong/claude-skills-plugin/tree/HEAD/skills/remotion

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

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

プレビュー

スキル README より

ドキュメント

使用するタイミング

Remotionコードを扱う際には、このスキルを使用してドメイン固有の知識を取得してください。

新しいプロジェクトのセットアップ

空のフォルダまたは既存のRemotionプロジェクトがないワークスペースで、以下を使用してプロジェクトをスキャフォールドします。

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

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

動画の設計

useCurrentFrame() と interpolate() を使用してプロパティをアニメーション化します。Easingを使用してアニメーションのタイミングをカスタマイズします。

import { useCurrentFrame, Easing } 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>;
};

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> はデフォルトで絶対フィル(absolute fill)です。インラインコンテンツの場合は 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>
  );
}

動画の width、height、fps、duration は 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 ファイルを読み込んで詳細を確認してください。

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 を参照してください。

ライトリーク

@remotion/light-leaks を使用したライトリークオーバーレイ効果については、rules/light-leaks.md を参照してください。

Lottieアニメーション

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

Canvas内のHTML

<HtmlInCanvas> を使用してHTMLを <canvas> にレンダリングし、2DまたはWebGLエフェクトを適用する必要がある場合は、rules/html-in-canvas.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 を参照してください。

関連スキル