Communitygithub.com

Ministry-of-Technology-AU/next-platform

Remotion のベストプラクティス - React で動画制作

next-platform とは?

このスキルは、Claude Code や Cursor、Codex などの AI エージェントが、Remotion(React ベースの動画作成フレームワーク)を扱う際にドメイン固有の知識を提供します。新しいプロジェクトのセットアップ方法、動画のデザイン原則、アニメーションの実装パターン、アセットの管理、キャプションや字幕、音声・映像エフェクト、3D コンテンツ、高度なタイミングやトランジションなど、幅広いトピックをカバーしています。また、各トピックに関連する詳細なルールファイルへの参照も含まれており、エージェントが必要に応じて深い知識を取得できるようになっています。このスキルは、Remotion Studio を使ったプレビューや FFmpeg を使った動画処理など、実践的なワークフローも提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ministry-of-Technology-AU/next-platform/tree/HEAD/.claude/skills/remotion-best-practices

お気に入りの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> はデフォルトで絶対フィル(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>
  );
}

動画の幅、高さ、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

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

キャプション

キャプションや字幕を扱う場合は、./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(), thermalVision(), blur(), linearProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst()。

3D コンテンツ

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

高度な音声

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

動的な持続時間、サイズ、データ

コンポジションの持続時間、寸法、プロパティを動的に設定するには、rules/calculate-metadata.md を参照してください。

高度なコンポジション

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

Google Fonts

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

ローカルフォント

ローカルフォントの読み込み方法については、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 を使用して Remotion コンポジションに AI 生成のボイスオーバーを追加する方法については、rules/voiceover.md を参照してください。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Ministry-of-Technology-AU/next-platform

Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques. Two modes — build interactive components with purposeful motion, or audit existing animations to catch AI-slop motion patterns (audit emits a branded HTML report with looping demos). Use when creating, adding, animating, or reviewing UI motion: transitions, hover states, micro-interactions, enter/exit animations, or any motion design work in React, Framer Motion, CSS, or HTML. Provides per-designer perspectives with context-aware weighting.

Ministry-of-Technology-AU/next-platform

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Ministry-of-Technology-AU/next-platform

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

関連スキル