Remotionセットアップ は何をしますか?
ここでは、新規の Remotion プロジェクトをスキャフォールディングし、以降のワークフローが「Claudeにプロンプトを送るだけ」で動くように配線します。これは一度だけ行う環境構築作業です。プロジェクトごとに1回実行すれば、以降 remotion-compose や remotion-render はクリエイティブループに直接入ります。
積極的にトリガーしてください。ユーザーが Claudeで動画を作る ことに関連する発言をした場合(「Remotionをセットアップ」「Remotionプロジェクトを作成」「Claudeで商品動画を作りたい」「動画プロジェクトを開始」など)、このスキルを実行します。
ステップ1 - ツールチェーンの確認
RemotionはヘッドレスChromiumでレンダリングを行うため、スキャフォールディング前にNodeを確認します:
node --version # 16以上が必要。アクティブLTSリリースを推奨
Nodeが16より古い場合は作業を中断し、ユーザーにアップグレードを促します(nvmの場合:nvm install --lts && nvm use --lts)。
また、npxが利用可能であることも確認します(npm 5.2+に同梱)。
ステップ2 - プロジェクトのスキャフォールディング
npx create-video@latest
これは対話型です。Blank(Hello World)テンプレートを推奨します。商品動画に最もクリーンなベースです。CLIがプロジェクトディレクトリとパッケージマネージャーを尋ねます。ユーザーに選択させ、新しいフォルダにcdしてインストールします:
cd <プロジェクト名>
npm install
ステップ3 - Remotion Agentスキルのインストール
Claude Codeがこのリポジトリ内でRemotionのスキルコンテキストを利用できるようにします:
npx remotion skills add remotion
これにより、Remotionのエージェントスキルファイルがプロジェクトに追加されます。インストール済みのRemotionバージョンでこのコマンドが利用できない場合は、新しいバージョンの @remotion/cli をユーザーに案内し、続行します。これは利便性のためのものであり、必須の依存関係ではありません。
ステップ4 - フォルダ構成の確立
後続のスキルが常に正しい場所を参照できるよう、レイアウトを標準化します:
src/
Root.tsx # すべての<Composition>を登録するエントリレジストリ
index.ts # registerRoot(RemotionRoot)
compositions/ # 動画ごとに1つの.tsxファイル - remotion-composeがここに書き込む
public/
assets/ # 画像、ロゴ、オーディオ - staticFile()で参照
テンプレートがフォルダを作成していない場合は作成します:
mkdir -p src/compositions public/assets
src/Root.tsx がレジストリです。すべての動画はここで <Composition> として登録されます:
// src/Root.tsx
import { Composition } from "remotion";
import { HelloWorld } from "./compositions/HelloWorld";
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="HelloWorld"
component={HelloWorld}
durationInFrames={90}
fps={30}
width={1920}
height={1080}
/>
);
};
// src/index.ts
import { registerRoot } from "remotion";
import { RemotionRoot } from "./Root";
registerRoot(RemotionRoot);
登録時の適切なデフォルト値:ランドスケープ商品動画には30fpsと1920x1080(縦型ソーシャルには1080x1920)、短い再生時間 - 30fpsで90フレームは3秒に相当し、ほとんどの商品デモ動画は15〜60秒(450〜1800フレーム)です。
ステップ5 - Googleフォントの読み込み
RemotionはGoogle Fontsをファーストクラスでサポートしており、テキストが確定的にレンダリングされます。一度インストールして読み込みます:
npm install @remotion/google-fonts
// コンポジションファイルの先頭付近で読み込む
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
// 使用例:<div style={{ fontFamily }}>...</div>
loadFont() はフォントの準備ができるまでレンダリングをブロックするため、画面上のテキストがスタイル未適用のフォールバックで一瞬表示されることはありません。ブランドに合ったフォントを選択してください - Inter を Poppins、Roboto などに置き換えてください。
ステップ6 - スモークテストコンポジション
環境がエンドツーエンドでレンダリングできることを確認するための簡単なコンポジションを作成します:
// src/compositions/HelloWorld.tsx
import { AbsoluteFill, useCurrentFrame, interpolate } from "remotion";
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
export const HelloWorld: React.FC = () => {
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: "clamp",
});
return (
<AbsoluteFill style={{ backgroundColor: "#0B0B0F", justifyContent: "center", alignItems: "center" }}>
<h1 style={{ fontFamily, color: "white", fontSize: 90, opacity }}>
It works.
</h1>
</AbsoluteFill>
);
};
これが src/Root.tsx(ステップ4)に登録されていることを確認し、レンダリングを実行します:
npx remotion render src/index.ts HelloWorld out/smoke-test.mp4
初回のレンダリングではヘッドレスChromiumをダウンロードします(数百MB - 通常の回線で初回は数分かかることがあります)。その後、この90フレームのスモークテストは1分以内にレンダリングされるはずです。out/smoke-test.mp4 がフェードインするタイトルを再生できれば、環境は正常です。レンダリングに失敗した場合、ほとんどの原因は(a) Chromiumのダウンロード/パーミッション、(b) コンポジションが Root.tsx に登録されていない、(c) ステップ1のNodeバージョンの問題です。
ステップ7 - プレビュー用にRemotion Studioを起動
インタラクティブなプレビュー(タイムラインのスクラブ、編集のホットリロード)を行う場合:
npx remotion studio
これによりStudioが http://localhost:3000 で提供されます。create-video テンプレートでは npm run dev も同じ動作に配線されています。イテレーション中はStudioを起動したままにしてください - コンポジションファイルの編集は即座にホットリロードされます。
成果物
ユーザーは動作するRemotionプロジェクトを手に入れます。具体的には、src/compositions/ + public/assets/ レイアウトが配置されたスキャフォールディング済みリポジトリ、インストールされたRemotion Agentスキル、配線されたGoogleフォント、登録済みのスモークテストコンポジション、実際に再生可能なレンダリング済み out/smoke-test.mp4、そしてプレビュー用に実行中のRemotion Studioです。スモークテストのMP4が存在して実際に再生されるまでは、「セットアップ完了」とはみなしません。
禁止事項
- Nodeチェックをスキップしてスキャフォールディングしないでください。16未満のNodeでは、インストール時ではなくChromiumレンダリングの深い部分で紛らわしいエラーが発生します。
- スモークテストのレンダリングなしでセットアップ完了と宣言しないでください。コンパイルは通るがMP4を出力したことのないプロジェクトは、Chromiumパイプラインが動作することを証明していません。
- コンポジションやアセットをアドホックな場所に配置しないでください。後続のスキル(
remotion-compose、remotion-render)はsrc/compositions/とpublic/assets/が存在することを前提としています。 - アセットを相対パスやURLで参照しないでください。
public/からstaticFile()を使用してください。そうしないと、ローカルでは動作しても他の環境ではレンダリングが壊れます。 - 画面上のテキストにシステムフォントやCSSインポートのフォントを使用しないでください。
loadFont()によるブロックがないと、レンダリングマシンでフォールバックフォントが使用される可能性があります。 - 商品動画に機能の多いテンプレートを選択しないでください。Blankテンプレートは、後でユーザーが削除する必要のあるデモコードを避けられます。
品質基準
node --versionが16以上であり、スキャフォールディング前にチェック済みであること。out/smoke-test.mp4が存在し、フェードインするタイトルを再生できること。- フォルダ構成が指定通りに存在し、スモークコンポジションが
src/Root.tsxに登録されていること。 - テキストが
@remotion/google-fontsのloadFont()を使用してレンダリングされており、システムフォールバックを使用していないこと。 - Remotion Studioがlocalhost:3000で起動し、編集のホットリロードが動作すること。
ハンドオフ
スモークテストがレンダリングされ、Studioが起動したら、ユーザーにプロジェクトの準備ができたことを伝え、次のように引き継ぎます:「セットアップ完了です。希望の動画 - 尺、シーン、ブランドカラー - を説明してください。コンポジションを作成し(remotion-compose)、レンダリングとイテレーションを行います(remotion-render)。」