Communitygithub.com

remotion-motion-design

Remotionを使用したコンポジション、タイムライン、シーンシステム、2D/3Dアニメーション、タイポグラフィ、トランジション、再利用可能コンポーネントの設計と実装を行います。

remotion-motion-design とは?

このスキルは、Remotionフレームワークを使用してプログラム的に動画を生成するための包括的なガイドです。開発者は、コンポジションの設定、タイムラインの設計、フレーム駆動のアニメーション、シーンの構造化、メディアアセットの管理、2D/3Dモーションの実装方法を学べます。主な機能には、useCurrentFrame() や spring() などの決定論的アニメーションAPIの正しい使用方法、Sequence/Seriesによるフレームルーティングパターン、コンポーネント分割のベストプラクティスが含まれます。このスキルは特に、グローバルフレームルーターとSeriesパターンの使い分けや、springアニメーションの減衰設定など、よくあるミスを防ぐためのルールを強調しています。Remotion 4.xをサポートし、TypeScript、React、SVG、Three.jsとの連携を想定しています。また、ピクセルアートやスティックマンアニメーションなど特殊なビジュアルスタイルのサポートも提供します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/achmdfzn/motionforge-atelier/tree/main/.claude/skills/remotion-motion-design

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

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

ドキュメント

REMOTION モーションデザイン — 実装スキル

1. コーディング前の確認

  • CLAUDE.md、MASTER_PROMPT.md、アーキテクチャドキュメントを読む。
  • 実際のRemotion/React/TypeScriptのバージョンとパッケージマネージャーを確認する。
  • 既存のエントリポイントとコンポジションレジストリを見つける。
  • リポジトリの規約に従う。必要なく依存関係を変更しない。
  • beyond-video、スクリプト、ストーリーボード、スタイルバイブルの出力を制作仕様として使用する。
  • メモリに頼らず、使用するAPIをインストール済みのRemotionソース(例:リファレンスクローンの packages/core/src)に対して検証する。

2. コンポジションプロファイル

デフォルト:

  • width: 1080
  • height: 1920
  • fps: 60
  • aspect: 9:16
  • duration: フレーム単位の正の整数

すべてのコンポジションには一意のIDと明示的なメタデータが必要です。理由なく複数のレイヤーで異なるFPS値を保存しないでください。

<Composition> は id、fps、width、height、durationInFrames、defaultProps、オプションで calculateMetadata(プロップからの動的なduration/metadata)と schema を受け入れます。durationInFrames は正の値でなければなりません。

3. タイムラインエンジニアリング

  • デュレーションと開始フレームは集中管理されたデータ/設定に保持する。
  • 1つのフレーム間隔規則を使用する。[start, end) を推奨する。
  • シーンの durationInFrames は正の値でなければなりません。
  • コンポジションの合計durationがすべてのシーンと末尾/クロージングを収容していることを確認する。
  • 重複とギャップを検証する。トランジション/コンポジットのために意図されている場合のみ重複を許可する。
  • 最終フレーム境界に浮動小数点数を使用しない。

4. 決定論的アニメーション — time/frame API(Remotion 4.x)

時刻ソース:

  • useCurrentFrame() — 現在のフレーム、0から始まるインデックス。コンポジションコンポーネント内でのみ使用可能。コンポジション外ではエラーをスローする。
  • useVideoConfig() — {width, height, fps, durationInFrames, id, defaultProps, defaultVideoImageFormat, ...} を返す。コンポジション外ではエラーをスローする。

補間とスプリング:

  • interpolate(input, inputRange, outputRange, options?) — number、string、boolean、array出力のオーバーロード。オプション:easing、extrapolateLeft / extrapolateRight('extend' | 'identity' | 'clamp' | 'wrap')、output、outputType、posterize。モーションが範囲を超えて実行されてはならない場合はクランプ補外を使用する。
  • spring({frame, fps, config?, from=0, to=1, durationInFrames?, durationRestThreshold?, delay=0, reverse=false})。SpringConfig:damping(デフォルト10)、mass(1)、stiffness(100)、overshootClamping(false)。damping <= 0 の場合、アニメーションは決して落ち着かず(無限ループエラー)。
  • measureSpring({fps, config?, threshold=0.005}) — スプリングが落ち着くまでのフレーム数。threshold=0 は Infinity を返す。

ルール:

  • モーションはフレームとプロップの関数でなければならない。
  • パーティクル/ノイズ/ランダム値をシードする。
  • 動画モーションの主要なソースとして、setInterval、setTimeout、requestAnimationFrame、Date.now()、自己実行CSSキーフレームを避ける。
  • コンポジションのレンダリング中にネットワークデータを取得しない。
  • 不安定なURLやログインが必要なURLからのオーディオ/ビデオを含めない。
  • delayRender(label?, options?) は continueRender(handle) が呼び出されるまでレンダリングを保持します(例:非同期アセット)。タイムアウトはCLI --timeout で設定します。

5. Sequence、Series、ローカルフレームとグローバルフレーム

これは最も間違えられやすいルールです。かつて Series.Sequence 内のコンポーネントがグローバルフレームを計算してしまったバグが実際に発生しました:

  • <Sequence> 内では、useCurrentFrame() はSequenceの開始位置を基準とした相対フレーム (frame - (cumulatedFrom + relativeFrom)) * playbackRate を返します。Sequence内のコンポーネントはグローバルフレームを見ることができません。
  • <Sequence> のプロップ:from?、name?、durationInFrames?(正の値でなければならず、loop を使用する場合は必須)、layout('absolute-fill' | 'none')、premountFor、loop、および切り抜きプロップ(layout="absolute-fill" の場合のみ)。
  • <Series.Sequence> は <Series> 内でのみ使用できます。<Series> 外で Series.Sequence を使用すると「このコンポーネントは <Series /> コンポーネント内になければなりません。」というエラーがスローされます。
  • 2つの有効なルーティングパターンがあります。1つを選択し、一貫して使用します:
    • グローバルフレームルーター(ビデオプロジェクトで使用):1つのルーターコンポーネントがグローバル useCurrentFrame() を使用し、その [start, end) 範囲でビートを選択します。ビートコンポーネントはグローバルフレームから計算します。
    • Series:各 Series.Sequence が1つのビートを保持します。ビートコンポーネントはローカルフレーム(Sequenceの開始位置で0)から計算します。
  • 明示的な理由なく、1つのコンポジション内で両方のパターンを混在させないでください。

6. シーン/コンポーネント構造

  • 1つのシーンは1つのナラティブ/ビジュアルの責任を持つ。
  • シーンプロップはTypeScriptで定義する。
  • 再利用可能なコンポーネントは明確なビジュアルタスクを解決する。
  • ビデオ全体を1つのファイルで保持するのは避ける。
  • コンテンツ設定、レンダラー、スタイルトークン、アセット参照を分離する。
  • オプションのアセットには設計されたフォールバックを追加する。重要なアセットがない場合は隠さない。

7. メディアコンポーネントとアセット

  • <Img src> — onError なしで読み込みに失敗した画像はレンダリングをキャンセルします(cancelRender)。重要なアセットには常に onError を提供するか、レンダリング前にアセットが存在することを確認する。
  • staticFile(path) — public/ 内のファイルにマッピングします。すべてのローカルアセット(画像、オーディオ、ビデオ)に使用します。
  • <Audio> — キューシートをプロップにマッピングする方法については sound-design を参照してください(trimBefore/After — 古いエイリアス startFrom/endAt — volume、playbackRate)。タイムライン上のキューの位置は <Sequence from> で設定します。トリムプロップはファイルのどの部分を再生するかを切り取るだけです。<Audio> には muted プロップはありません。ミュートはCLIフラグ(--muted)です。
  • <Video> / <OffthreadVideo> と <Still> も同じフレームルールに従います。メディアの長さはフレームからスケジュールされ、ファイルのメタデータからではありません。

8. 2Dモーション

必要に応じてSVG/シェイプ/CSS/ラスターを使用します。アンカー、トランスフォームの原点、アンチエイリアシング、レイヤリング、クリッピング、セーフエリアに注意してください。すべてのトランスフォームはフレーム駆動でなければなりません。

9. ピクセルアートとスティックマンサポート

ピクセルアート:

  • 論理キャンバスとピクセルスケールを固定する。
  • スプライトを拡大するときは最近傍補間を使用する。
  • 必要に応じて位置をグリッドにスナップする。
  • パレットとスプライト寸法を固定する。
  • ぼかしとサブピクセルちらつきを避ける。

スティックマン:

  • プロポーションとピボットを一貫させる。
  • プロジェクトの規模が許す場合はポーズ/リグライブラリを使用する。
  • シルエットとジェスチャーを読み取れるようにアニメーション化する。
  • 表情/ポーズをストーリービートと同期させる。

歩行サイクル、フォロースルー、アイドルモーションについては character-animation を参照してください。

10. 3Dモーション

  • 創造的な価値がある場合のみ3Dを追加する。
  • three、@react-three/fiber、@remotion/three のバージョンとそれらのドキュメントを確認する。
  • Remotion ThreeCanvas統合については、インストールされているAPIバージョンのフレーム駆動アプローチに従う。リアルタイムR3Fパターンが自動的に決定論的であると想定しない。
  • カメラ、トランスフォーム、マテリアル、ライティング、パーティクルをフレームから駆動する。
  • レンダラー/ヘッドレス互換性、テクスチャサイズ、ジオメトリ、計算コストを考慮する。
  • 読みやすさと保守性に役立つ場合は、3Dレイヤーを2Dタイポグラフィ/オーバーレイから分離する。
  • 3Dシーンを詳細にディレクションする方法については 3d-scene-director を参照してください。

11. タイポグラフィとトランジション

  • 階層と可読性を優先する。
  • トランジションで重要なコピーを隠さない。
  • すべてのトランジションは2つのビートを接続する。機能なしにエフェクトを追加しない。
  • モーションカーブと強度をスタイルバイブル全体で一貫させる。
  • テキストの長さを読み取り時間に合わせる。

12. クロージングの実装

beyond-video ワークシートに従って、クロージングのロゴとCTAを実装する。ロゴは公式アセットまたは承認されたプレースホルダーから提供されなければなりません。コピー、タイミング、モチーフ、コンポジションは、対象のビデオのために作られたように感じられる必要があります。

13. 引き渡し前のQA

コンポジションID、メタデータ、フレーム範囲、インポート、型、静的アセット、フォント、スタイルの一貫性、セーフエリア、クロージング、アセットライセンスを確認する。利用可能なlint/typecheck/テストを実行する。MP4をレンダリングしない。コミット/プッシュしない。

出力形式

  • コンポジションレジストリ:ID、1080×1920、60 FPS、durationInFrames、シーンリスト+フレーム範囲。
  • 使用したAPI:API名+関連シグネチャ+検証場所(インストール済みRemotionバージョン)。
  • フレームルーティングパターン:グローバルまたはSeries。1つの選択、コンポジション全体で一貫させる。
  • アセットレジスタ:ファイル、staticFile、重要アセットごとのフォールバック/onError。
  • QAチェックリスト+typecheck/lintの結果。

ミニ例

グローバルフレームルーター(ビデオプロジェクトパターン):

const frame = useCurrentFrame();
const beat = BEATS.find((b) => frame >= b.start && frame < b.end);
return (
  <AbsoluteFill>
    {beat?.id === 'S01-B01' && <Hook />}
    {beat?.id === 'S01-B02' && <Problem />}
  </AbsoluteFill>
);

測定されたデュレーションを持つスプリング:

const settle = measureSpring({fps, config: {damping: 12}});
const progress = spring({frame, fps, config: {damping: 12}});

失敗モード

  • Series.Sequence 内のコンポーネントがグローバルフレームを計算する → 間違ったビート、シーンが間違ったタイミングで表示される。修正:ローカルフレームから計算するか、グローバルフレームルーターに切り替える。
  • Series.Sequence を <Series> なしで使用する → レンダリング時にスローされる。<Series> でラップするか、<Sequence> を直接使用する(Series.Sequence ではなく)。
  • spring を damping <= 0 で使用する → アニメーションが決して落ち着かない。damping > 0 を維持する。
  • onError なしで画像がない → レンダリングがキャンセルされる。onError を追加するか、レンダリング前にアセットが存在することを確認する。
  • useCurrentFrame()/useVideoConfig() をコンポジション外で使用する → スローされる。コンポジションコンポーネント内でのみ呼び出す。

Individual skills in this repo

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

関連スキル