Remotion — ツールキット拡張
Remotion のコア知識 は
.claude/skills/remotion-official/にあります(公式 remotion-dev/skills リポジトリから同期)。このファイルは ツールキット固有 のパターンのみを扱います。
共有コンポーネント
lib/components/ にある再利用可能なビデオコンポーネント。テンプレートでは以下のようにインポートします:
import { AnimatedBackground, SlideTransition, Label } from '../../../../lib/components';
| コンポーネント | 目的 |
|---|---|
AnimatedBackground | 浮遊する図形の背景(バリエーション: subtle, tech, warm, dark) |
SlideTransition | シーントランジション(フェード、ズーム、スライドアップ、ブラーフェード) |
Label | オプションのJIRA参照付きフローティングラベルバッジ |
Vignette | シネマティックなエッジ暗転オーバーレイ |
LogoWatermark | コーナーロゴブランディング |
SplitScreen | サイドバイサイドのビデオ比較 |
NarratorPiP | ピクチャー・イン・ピクチャーのプレゼンターオーバーレイ |
Envelope | フラップ開閉アニメーション付き3D封筒 |
PointingHand | スライドインとパルス付きアニメーションハンド絵文字 |
MazeDecoration | コーナー用アニメーション等角グリッド装飾 |
カスタムトランジション
ツールキットには、lib/transitions/ にシーン間エフェクト用のトランジションライブラリが含まれており、公式の @remotion/transitions パッケージを超える効果を提供します。
TransitionSeries の使用
import { TransitionSeries, linearTiming } from '@remotion/transitions';
// カスタムトランジションを lib からインポート(パスはプロジェクトの場所に合わせて調整)
import { glitch, lightLeak, clockWipe, checkerboard } from '../../../../lib/transitions';
// 公式トランジションは @remotion/transitions からインポート
import { slide, fade } from '@remotion/transitions/slide';
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={glitch({ intensity: 0.8 })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
利用可能なカスタムトランジション
| トランジション | オプション | 最適な用途 |
|---|---|---|
glitch() | intensity, slices, rgbShift | テックデモ、エッジの効いた演出、サイバーパンク |
rgbSplit() | direction, displacement | モダンテック、エネルギッシュなトランジション |
zoomBlur() | direction, blurAmount | CTA、ハイエネルギーな瞬間、インパクト |
lightLeak() | temperature, direction | お祝い、フィルム風、温かみのある瞬間 |
clockWipe() | startAngle, direction, segments | 時間関連コンテンツ、遊び心のある演出 |
pixelate() | maxBlockSize, gridSize, scanlines, glitchArtifacts, randomness | レトロ/ゲーム、デジタル変換 |
checkerboard() | gridSize, pattern, stagger, squareAnimation | 遊び心のある演出、構造化トランジション |
チェッカーボードパターン: sequential, random, diagonal, alternating, spiral, rows, columns, center-out, corners-in
トランジション例
// テック/サイバーパンク風
glitch({ intensity: 0.8, slices: 8, rgbShift: true })
// 温かいお祝い
lightLeak({ temperature: 'warm', direction: 'right' })
// ハイエナジーなズーム
zoomBlur({ direction: 'in', blurAmount: 20 })
// 色収差
rgbSplit({ direction: 'diagonal', displacement: 30 })
// 時計回り演出
clockWipe({ direction: 'clockwise', startAngle: 0 })
// レトロピクセル化
pixelate({ maxBlockSize: 50, glitchArtifacts: true })
// チェッカーボードパターン
checkerboard({ pattern: 'diagonal', gridSize: 8 })
checkerboard({ pattern: 'spiral', gridSize: 10 })
checkerboard({ pattern: 'center-out', squareAnimation: 'scale' })
トランジション期間のガイドライン
| 種類 | フレーム数 | 備考 |
|---|---|---|
| クイックカット | 15-20 | 速く、パンチ力がある |
| 標準 | 30-45 | 最も一般的 |
| ドラマチック | 50-60 | ゆっくりとした演出 |
| グリッチ効果 | 20-30 | 突然感が必要 |
| ライトリーク | 45-60 | スイープする時間が必要 |
トランジションのプレビュー
ショーケースギャラリーを実行してすべてのトランジションを確認:
cd showcase/transitions && npm run studio
ツールキットのベストプラクティス
- フレームベースのアニメーションのみ — CSSトランジション/アニメーションを避ける。レンダリング時にちらつきを引き起こす
- useVideoConfig() から fps を使用 — アニメーションをフレームレート非依存にする
- 補間をクランプ —
extrapolateRight: 'clamp'を使用して値の暴走を防ぐ - OffthreadVideo を使用 — 複雑なコンポジションでは
<Video>よりパフォーマンスが良い - 非同期処理には delayRender — データ準備が完了するまでレンダリングをブロックする
- アセットには staticFile —
public/フォルダ内のファイルを正しく参照 - 全プロジェクトは 30fps を使用 — タイミング: フレーム = 秒数 × 30
- playbackRate は一定に保つ — 可変/極端な速度の場合は、FFmpeg で事前処理
プロジェクトタイミング規約
| シーン種類 | 長さ | 備考 |
|---|---|---|
| タイトル | 3-5秒 (90-150f) | ロゴ + 見出し |
| 概要 | 10-20秒 | 3-5つの箇条書き |
| デモ | 10-30秒 | 必要に応じて playbackRate を調整 |
| 統計 | 8-12秒 | 3-4枚の統計カード |
| クレジット | 5-10秒 | クイックフェード |
ペース: 音声で約150単語/分。音声がタイミングを決定します。
高度なAPI
すべてのフック、コンポーネント、レンダラー、Lambda、プレーヤーAPIの詳細については、reference.md を参照してください。
ライセンス注意事項
Remotion には特別なライセンスがあります。企業は商用利用のためにライセンスを取得する必要がある場合があります。https://remotion.dev/license を確認してください。
フィードバックと貢献
このスキルに情報が不足している場合や改善できる点がある場合:
- パターンが足りない? 必要なものを説明してください
- エラーを見つけた? 何が間違っているか教えてください
- 貢献したい? 以下を支援できます:
- このスキルを改善点で更新
- github.com/digitalsamba/claude-code-video-toolkit へのPR作成
「このスキルを改善してください」と言うだけで、.claude/skills/remotion/SKILL.md の更新手順を案内します。