Communitygithub.com

beimeibeile/Remotion-controls-skill

Remotion コード駆動型ビデオアニメーション専門制御スキル。React/TypeScript コードで2Dアニメーションを精密制御し、ネイティブで透明背景(アルファチャンネル)レンダリングをサポート。WebM/MOV の透明チャンネル付き動画を出力可能。剪映テンプレートのアニメーション素材、UIアニメーション、テキストタイポグラフィアニメーション、2Dキャラクターアニメーションなどのシーンに適しています。APIサービス化、テンプレートライブラリ、品質管理、自己学習進化機能を提供します。

Remotion-controls-skill とは?

Remotion Controls Skill は、コードでビデオアニメーションを駆動するためのプロフェッショナルスキルです。ReactとTypeScriptを使用して各フレームを完全に制御し、透明背景(アルファチャンネル)のレンダリングをネイティブサポートします。主な機能には、透明背景動画(WebM VP9 / MOV ProRes 4444)の出力、HTTP APIを介したアニメーション指示の受け付け、プリセットテンプレートライブラリ(キャラクター、UI、テキスト、トランジションエフェクト)、フレームレート・解像度・アルファチャンネル完全性の自動品質チェック、レンダリングパラメータと効果スコアを記録する自己学習進化システムが含まれます。ComfyUI(AI生成画像・動画)やBlender(3Dアニメーション)とは異なり、2Dのコード駆動アニメーション、特に透明背景が必要なテンプレート素材制作に特化しています。ai-video-editorと連携し、透明背景動画を剪映テンプレートのアニメーション素材として提供することができます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add beimeibeile/Remotion-controls-skill

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

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

ドキュメント

Remotion Controls Skill

コードでビデオアニメーションを駆動するプロフェッショナル制御スキル。Remotion は React ベースの動画作成フレームワークであり、コードで各フレームを正確に制御し、透明背景のレンダリングをネイティブでサポートします。

コア機能

機能説明
透明背景レンダリングアルファチャンネルをネイティブサポート。WebM(VP9) / MOV(ProRes 4444) で透明動画を出力
コードによる精密制御React/TypeScript で位置、スケール、回転、透明度、イージングカーブを正確に制御
APIサービス化HTTP API でアニメーション指示を受け取り、動画ファイルを出力
テンプレートライブラリプリセットアニメーションテンプレート(キャラクターアニメーション、UIアニメーション、テキストアニメーション、トランジションエフェクト)
品質管理フレームレート、解像度、ビットレート、アルファチャンネルの完全性を自動検出
自己学習進化レンダリングパラメータと効果スコアを記録し、プリセットパラメータを最適化

ComfyUI / Blender とのポジショニングの違い

スキルコアアドバンテージ適用シーン
ComfyUI-controlsAI生成(画像/動画/音声)、クリエイティブ制御不可キャラクター画像/シーン画像/エフェクト動画生成
Blender-controls3Dアニメーション、物理シミュレーション、高品質レンダリング3Dキャラクターアニメーション、プロダクトプレゼンテーション、物理エフェクト
Remotion-controls2Dコードアニメーション、精密制御可能、透明背景テンプレートアニメーション素材、UIアニメーション、テキストタイポグラフィ、2Dキャラクターアニメーション

クイックスタート

1. 依存関係のインストール

cd remotion-project
npm install

2. 透明背景動画のレンダリング

# CLI 方式
npx remotion render src/index.ts MyComp out/video.webm --transparent

# API 方式
python remotion_controls.py render --composition MyComp --output out/video.webm --transparent

3. API サービスの起動

python remotion_controls.py serve --port 8765

透明背景レンダリングの説明(検証済みフロー)

Remotion は透明背景をネイティブサポートしていますが、CLI の --transparent エンコードではアルファチャンネルが失われます(WebM VP8/VP9、MOV ProRes で確認済み)。

検証済みの正しいフロー(PIT-024):

  1. PNGシーケンスレンダリング:npx remotion render src/index.ts Composition out/frames --sequence(アルファ付きPNGシーケンスを出力)
  2. ffmpegでProRes 4444に合成:
    ffmpeg -y -framerate 30 -i out/frames/%04d.png \
      -c:v prores_ks -profile:v 4 -pix_fmt yuva444p12le \
      out/animation.mov
    
  3. アルファチャンネルの検証:python verify_animation.py out/animation.mov

剪映統合に関する注意事項(PIT-024):

  • add_media_safe で ProRes 4444 mov をインポートすると自動的に H.264 mp4 にトランスコードされ、アルファが失われます(66MB→0.07MB)
  • 手動インポートが必要:mov を直接草稿 materials ディレクトリにコピー → VideoMaterial を作成 → materials.videos に登録 → VideoSegment(material=anim_material) → add_segment

アニメーション素材品質基準

完全な基準は QUALITY_STANDARD.md を参照してください。

合格アニメーション素材の必須指標:

  • アルファチャンネル保持(yuva444p12le)
  • ProRes 4444 エンコード(profile=4)
  • 解像度/フレームレート/持続時間が設定と一致
  • コンテンツカバレッジ ≥ 50%(10ポイントサンプリング)
  • ファイルサイズが適切(≤15MB/秒)

自動検証:

python verify_animation.py <アニメーションファイル> --duration 20 --width 1080 --height 1920

基本アニメーションコンポーネントライブラリ

remotion-project/src/components/ にあり、すべてのコンポーネントが透明背景をサポートしています。

キャラクターとモーションコンポーネント

コンポーネント説明
CharacterSpriteキャラクタースプライト:複数ポーズ切替、位置/スケール/回転/透明度のキーフレームアニメーション
MotionPathモーションパス:線形/ベジェ/弾性/バウンス運動
FlashEffectフラッシュエフェクト:高速フェードイン、低速フェードアウト
ShakeEffectシェイクエフェクト:振幅減衰するランダム振動
FadeEffectフェードイン/アウト:制御可能なフェードイン/アウト時間
PopEffectポップエフェクト:弾性スケーリングによるポップ表示
SlideEffectスライドエフェクト:4方向イーズアウトスライド

テキストアニメーションコンポーネント(TextAnimations.tsx)

コンポーネント説明適用シーン
TextReveal文字ごとの表示:タイプライター/フェードイン/スライドアップ/スライドレフトナレーション、セリフ、タイトル登場
TextPopポップテキスト:スケール/回転/バウンスキーワード強調、ビート合わせ
TextWaveウェーブテキスト:文字ごとのサイン波浮遊遊び心のあるスタイル、BGMリズム
TextGlitchグリッチエフェクト:RGB分離+震えテクノロジー感、グリッチアート、トランジション
TextGradientグラデーションフロー:色の流れ+スキャンライトタイトル、ブランド名、高級感
KineticTextキネティックタイポグラフィ:複数行の組み合わせアニメーションオープニングタイトル、エンドロール

トランジションエフェクトコンポーネント(TransitionEffects.tsx)

コンポーネント説明適用シーン
FadeTransitionフェードイン/アウトトランジション(in/out/inOut)汎用トランジション、感情の移行
SlideTransitionスライドトランジション(上下左右)シーン切り替え、コンテンツ置換
ZoomTransitionズームトランジション(押し出し/引き寄せ)重点強調、レンズの推進
WipeTransitionワイプトランジション(上下左右/対角線)クリエイティブトランジション、スタイル化
BlurTransitionブラートランジション(ぼかし→鮮明)夢幻的な移行、回想フラッシュバック
GlitchTransitionグリッチトランジション(RGB分離+走査線)テクノロジー感、グリッチアート

インパクトエフェクトコンポーネント(ImpactEffects.tsx)

コンポーネント説明適用シーン
PunchImpactパンチインパクト(衝撃波+星+フラッシュ)格闘、打撃、衝突
ImpactFlashインパクトフラッシュ(高速フラッシュ)強打、爆発、ビート合わせ
ParticleBurstパーティクルバースト(星/火花/破片)祝福、爆発、衝撃
Shockwaveショックウェーブ(複数リング拡散)エネルギー放出、爆発、振動感
SpeedLinesスピードライン(放射状)高速衝撃、ダッシュ、連打

使用例:

import { PunchImpact, ParticleBurst, FadeTransition } from "./components";

// 格闘シーン
<PunchImpact startFrame={90} x={540} y={800} scale={1.2} />
<ParticleBurst startFrame={90} x={540} y={800} count={16} particleType="star" />
<FadeTransition direction="in" duration={15} startFrame={0} color="#1a1a2e" />

使用例:

import { CharacterSprite, FlashEffect, TextReveal, TextPop } from "./components";

<CharacterSprite
  poses={[
    { name: "idle", image: "/doubao_normal.png", frameRange: [0, 90],
      position: [{frame: 0, x: 0, y: 0}, {frame: 90, x: 100, y: 0}] },
    { name: "falling", image: "/doubao_falling.png", frameRange: [90, 150] },
  ]}
  width={250} height={250}
/>
<FlashEffect startFrame={90} duration={10} />
<TextReveal text="被打った!" fontSize={56} startFrame={95} revealType="typewriter" />
<TextPop text="痛い!" fontSize={72} color="#ff6b6b" startFrame={110} popType="bounce" />

プロジェクト構造

remotion-controls-skill/
├── SKILL.md                    # 本ファイル
├── QUALITY_STANDARD.md         # アニメーション素材品質基準
├── verify_animation.py         # 自動検証ツール
├── remotion_controls.py        # メイン制御スクリプト(CLI/API)
├── .env.example                # 環境変数例
├── .gitignore
├── capabilities/
│   ├── cap_api_wrapper/        # Remotion API ラッパー
│   ├── cap_animation_renderer/ # アニメーションレンダラー
│   ├── cap_template_library/   # アニメーションテンプレートライブラリ
│   ├── cap_quality_control/    # 品質管理
│   └── cap_self_evolution/     # 自己学習進化
├── remotion-project/           # Remotion プロジェクト
│   ├── src/
│   │   ├── components/         # 基本アニメーションコンポーネントライブラリ
│   │   │   ├── CharacterSprite.tsx
│   │   │   ├── MotionPath.tsx
│   │   │   ├── Effects.tsx
│   │   │   └── index.ts
│   │   ├── AnimationTemplate.tsx  # JSON駆動のアニメーションテンプレート
│   │   ├── Root.tsx
│   │   └── index.ts
│   ├── public/                 # 静的素材(キャラクター/小道具画像)
│   └── package.json
└── out/                        # レンダリング出力

機能モジュール

cap_api_wrapper — Remotion API ラッパー

  • render_media():動画レンダリング(透明背景対応)
  • render_still():単一フレーム画像レンダリング
  • select_composition():利用可能な Composition のリスト取得
  • get_props_schema():Composition の Props 定義取得

cap_animation_renderer — アニメーションレンダラー

  • アニメーション指示 JSON を入力 → 透明背景動画を出力
  • キーフレームアニメーション対応(位置/スケール/回転/透明度)
  • イージングカーブ対応(ease-in/ease-out/ease-in-out/linear/spring)
  • 複数レイヤー合成対応

cap_template_library — アニメーションテンプレートライブラリ

  • キャラクターアニメーションテンプレート(豆包被打、表情切替など)
  • UIアニメーションテンプレート(ボタンクリック、ページ切替など)
  • テキストアニメーションテンプレート(タイプライター、フェード、バウンスなど)
  • トランジションエフェクトテンプレート(フェード、スライド、ズームなど)

cap_quality_control — 品質管理

  • フレームレート検出(24/30/60fps)
  • 解像度検出(1080p/4K)
  • アルファチャンネル完全性検出
  • 動画時間と期待値の比較
  • ファイルサイズ妥当性チェック

cap_self_evolution — 自己学習進化

  • レンダリングパラメータと効果スコアを記録
  • プリセットパラメータの最適化
  • ベストプラクティスドキュメントの生成
  • テンプレート効果ランキング

環境変数

REMOTION_PROJECT_PATH=./remotion-project
REMOTION_OUTPUT_DIR=./output
REMOTION_DEFAULT_FPS=30
REMOTION_DEFAULT_WIDTH=1080
REMOTION_DEFAULT_HEIGHT=1920
REMOTION_API_PORT=8765

ai-video-editor との統合

Remotion-controls-skill は ai-video-editor のアニメーション素材作成ツールとして機能します:

  1. ai-video-editor のディレクターエンジンがアニメーション指示を出力
  2. Remotion-controls-skill が指示を受け取り、透明背景動画をレンダリング
  3. 透明背景動画が剪映テンプレートのアニメーション素材レイヤーとして使用される
  4. ユーザーが背景を差し替えると、アニメーションが完璧に重なる

注意事項

  • Remotion には Node.js 18+ 環境が必要です
  • 透明背景動画には WebM 形式を推奨(剪映との互換性が良好)
  • 長時間動画のレンダリングには時間がかかるため、分割レンダリング後に合成することを推奨
  • アニメーション内で CSS フィルターは使用しないでください(一部のフィルターは透明背景をサポートしません)

関連スキル