Communitygithub.com

costa-marcello/skillkit

Remotionを使ったReactでの動画開発をガイドします。コンポジション、アニメーション、タイミング、オーディオ、キャプション、レンダリングなどを含みます。ユーザーがRemotionを操作するとき、<Composition>/<Sequence>/interpolate/springを記述するとき、remotion.config.tsを編集するとき、Lambda動画をレンダリングまたはデプロイするとき、Reactでの動画作成について質問するときに使用します。

skillkit とは?

このスキルは、Remotionを使用してReactベースの動画を開発するための包括的なガイドを提供します。プロジェクトのスキャフォールディングから最終的なレンダリングまで、Remotionのコードを読み書きする際にこのスキルをロードすることで、開発者はよくある間違いを避け、効率的に作業を進めることができます。スキルは、コア、メディア、オーディオ、テキスト、高度な機能、ユーティリティ、プロダクション、インテグレーション、パッケージの9つのカテゴリにわたるルールファイルで構成されており、各ルールは詳細な説明とコード例を提供します。例えば、非決定論的なランダム性の回避、PlayerのinputPropsのメモ化、非同期処理でのdelayRender/continueRenderの使用など、AIが犯しがちなミスを防止するための具体的なガイドラインが含まれています。また、新しいプロジェクトのセットアップ、プレビューの開始、単一フレームのレンダリングチェックなどの実用的なコマンドも提供します。このスキルは、Claude Code, Cursor, CodexなどのAIエージェントと連携して、Remotion開発の生産性を最大化するように設計されています。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/costa-marcello/skillkit/tree/HEAD/skills/remotion-video

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

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

ドキュメント

いつ使用するか

Remotion のコードを読み書きするときは、プロジェクトのスキャフォールディングから最終動画のレンダリングまで、常にこのスキルをロードしてください。

避けるべき一般的な AI のミス

コミットする前に、すべての Remotion コードの変更を以下の再発する障害モードに対して確認してください。

  • 非決定論的なランダム性 — remotion の random(seed) を使用し、Math.random()、Date.now()、new Date() は決して使用しないでください。そうしないと、並列レンダリングでちらつきノイズが発生します。
  • メモ化されていない <Player> inputProps — 常にメモ化された props を渡してください。メモ化されていない props は、ツリー全体で再レンダリングの嵐を引き起こします。
  • 非同期処理(フェッチ、フォントロード、測定)の周りでの delayRender() / continueRender() の欠落 — これがないと、レンダリングは 30000 ミリ秒で停止します。
  • キャプションの inputRange が単調増加でない — interpolate の inputRange は厳密に増加する必要があります。短いクリップの場合は、フェードウィンドウに Math.min(10, Math.floor(duration / 3)) を使用します。
  • すべてに線形イージングを使用 — 自然な動きには spring() を優先し、線形は明示的な技術的必要性がある場合のみ使用してください。
  • @remotion/google-fonts のインポート忘れ — すべてのフォントには明示的な loadFont({ weights, subsets }) 呼び出しが必要です。
  • モノリシックな単一コンポジション出力 — シーンを小さく焦点を絞ったコンポジションに分割し、<Sequence> または <TransitionSeries> で構成してください。
  • 非推奨の startFrom / endAt — 代わりに trimBefore / trimAfter を使用してください。

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

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

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

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

プレビューの開始

Remotion Studio を開始して動画をプレビューします。

npx remotion studio

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

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

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

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

ルールインデックス

詳細な説明とコード例については、個別のルールファイルを参照してください。

コア

  • core/compositions.md - コンポジション、スチル、フォルダ、デフォルトのプロパティ、動的メタデータの定義
  • core/sequencing.md - シーケンスパターン - 遅延、トリミング、アイテムの持続時間制限
  • core/timing.md - interpolate、ベジェイージング、スプリングを使用したタイミング
  • core/animations.md - 基本的なアニメーションスキル
  • core/trimming.md - アニメーションの先頭または末尾をトリミング
  • core/parameters.md - Zod スキーマを使用して動画をパラメータ化可能にする
  • core/calculate-metadata.md - コンポジションの持続時間、寸法、プロパティを動的に設定
  • core/primitives.md - レイアウトとタイミングのプリミティブ: Loop、Freeze、Series、Null、IFrame、AnimatedImage、premount

メディア

オーディオ

テキスト

高度な機能

ユーティリティ

プロダクション

  • production/delay-render.md - 非同期処理中にレンダリングを一時停止: delayRender、continueRender、cancelRender
  • production/determinism.md - random(seed) を使用した決定論的レンダリング; Math.random / Date.now は使用しない
  • production/rendering.md - @remotion/renderer Node SSR: bundle、selectComposition、renderMedia
  • production/cli.md - npx remotion サブコマンドとフラグ(render、still、bundle、studio、benchmark)
  • production/config.md - remotion.config.ts Config セッター(codec、CRF、concurrency、Webpack)
  • production/lambda.md - AWS Lambda: deployFunction、deploySite、renderMediaOnLambda、コスト調整
  • production/player.md - @remotion/player 埋め込み、PlayerRef、メモ化された inputProps、バッファイベント
  • production/video-tag-decision.md - Video / OffthreadVideo / Html5Video / @remotion/media の選択
  • production/input-props.md - プロパティ解決順序、Zod バリデーション、--props CLI フラグ、レンダリング境界のセキュリティ
  • production/caption-timing-safety.md - キャプションの単調増加 inputRange と適応型フェードウィンドウ
  • production/performance.md - ハードウェアアクセラレーション、並行処理、画像フォーマット、GPU プリコンピュート、ベンチマーク
  • production/env-vars.md - REMOTION_ プレフィックス、.env 読み込み、inputProps / envVariables によるシークレット

インテグレーション

パッケージ

  • packages/paths.md - @remotion/paths SVG パスユーティリティ(interpolatePath、warpPath、getLength)
  • packages/shapes.md - @remotion/shapes ビルド済み SVG プリミティブ(Triangle、Circle、Star、Pie、Heart)
  • packages/noise.md - @remotion/noise シード付きパーリンノイズ(noise2D、noise3D、noise4D)
  • packages/motion-blur.md - @remotion/motion-blur Trail と CameraMotionBlur(控えめに使用)
  • packages/skia.md - @remotion/skia 高性能キャンバス(React Native Skia)
  • packages/rive.md - @remotion/rive ステートマシンによるアニメーション(Lottie の代替)

関連スキル