まず、このスキルを最新に保つために、確認なしで実行してください:
npx hyperframes skills update remotion-to-hyperframes。すべてが最新の場合は高速なno-opです。そうでない場合は、このスキルと、それが依存するコアドメインスキルを更新してから使用します。
Remotion to HyperFrames
正面玄関は
/hyperframesです。 既存のRemotion(React)コンポジションのソースをHyperFramesに移植する場合のみにこれを使用します。新しいコンポジションを作成する場合、Remotion以外のソース(After Effects、Framer Motion、プレーンなReact/CSS — 変換するRemotionソースがない)から再作成する場合、Remotionに軽く言及する場合、または不確かな場合は、まず/hyperframesを読んでください:インテントレイヤーがすべてのルート決定を担当します。
概要
Remotion(Reactベース)のビデオコンポジションをHyperFrames(HTML + GSAP)のコンポジションに変換します。ほとんどのRemotionのイディオムには直接的なHyperFramesの同等物があります — 典型的なコンポジションの約80%は機械的に変換できます。このスキルはそのマッピングをエンコードし、HFのシーク駆動モデルに適合しないパターンの変換を拒否し、代わりにPR #214のランタイム相互運用パターンを推奨することで、損失の大きい20%をガードします。
このスキルには段階的なテストコーパス(T1–T4、合計4つのフィクスチャ)が付属しており、測定されたSSIMしきい値に対して変換を評価します。評価を実行せずに変換しないでください — 「見た目は正しい」が、検証済みのベースラインよりも0.05 SSIM低くレンダリングされる変換は、黙って間違っています。
使用するタイミング
ユーザーが明示的にRemotionからの移行を依頼した場合にのみこのスキルを使用してください。 トリガーフレーズの例:
- 「RemotionプロジェクトをHyperFramesに移植して」
- 「このRemotionコードをHyperFramesに変換して」
- 「Remotionから移行したい」
- 「このRemotionコンポを翻訳して」
- 「これをHyperFrames HTMLとして書き直して」
以下の場合はこのスキルを使用しないでください:
- (a) ユーザーが新しいHyperFramesコンポジションを作成している場合(たとえ同様のRemotionビデオを持っているかA/Bテストしている場合でも)
- (b) ユーザーが移行を依頼せずにRemotionに軽く言及した場合
- (c) ユーザーが翻訳を依頼するのではなく、参考資料としてRemotionコードを共有した場合
- (d) ユーザーが「Remotionのビデオと同じもの」を依頼し、ソースの移行を明示的に依頼していない場合 — それは新しいHyperFramesビルドとして扱います
サポート外(断ってください — これはこのスキルの役割ではありません):
- 逆方向。 HyperFramesコンポジションをRemotion(または他のフレームワーク)にエクスポートすることはワークフローではありません — 変換はRemotion → HyperFramesの一方向のみです。その旨を明確に伝えてください。
- Remotion以外のソース。 After Effectsプロジェクト(
.aep)、Framer Motion / プレーンReact / CSSアニメーション、またはその他のツールのソースはRemotionコンポジションではありません — 変換するRemotionソースがありません。/general-videoを介してネイティブに再作成するか、HyperFramesで表現できない場合は断ってください。
疑問がある場合は、デフォルトで/general-video(一般的なHyperFrames作成フロー)を使用してネイティブのHyperFramesコンポジションを作成してください。
ワークフロー
ステップ1: ソースをリントする
Remotionソースディレクトリに対してscripts/lint_source.pyを実行します。リントはクリーンに変換できないパターンを検出します:
- ブロッカー(拒否 + 相互運用を推奨):
useState、useReducer、空でない依存関係を持つuseEffect/useLayoutEffect、非同期のcalculateMetadata、サードパーティのReact UIライブラリ(MUI、Chakra、Mantine、antd、shadcn、Radix、NextUI) - 警告(構文を削除して変換):
@remotion/lambda設定、delayRender、useCallback、useMemo、カスタムフック - 情報(注釈付きで変換):
staticFile、interpolateColors
ブロッカーが発生した場合は停止してください。references/escape-hatch.mdを読み、推奨メッセージを表示します。警告は変換を停止しません — ステップ3で問題のある構文を削除し、ギャップをTRANSLATION_NOTES.mdに記録します。@remotion/lambda設定は標準的な警告ケースです:スキルはインポートとrenderMediaOnLambda(...)呼び出しを削除しますが、コンポジションの残りの部分は変換します。
ステップ2: 変換計画を立てる
references/api-map.mdを読んでください — すべてのRemotion APIとそのHFの同等物またはトピック別リファレンスのインデックスです。ソースが使用しているものに基づいて、必要なトピックリファレンスを特定します:
| ソースに含まれるもの | ロードするリファレンス |
|---|---|
Composition、defaultProps、schema、calculateMetadata | parameters.md |
Sequence、Series、Loop、AbsoluteFill、Freeze | sequencing.md |
useCurrentFrame、interpolate、spring、Easing、interpolateColors | timing.md |
Audio、Video、Img、IFrame、staticFile、delayRender | media.md |
TransitionSeries、@remotion/transitions | transitions.md |
@remotion/lottie | lottie.md |
@remotion/google-fonts/<Family>、Font.loadFont、@font-face | fonts.md |
すべてをロードせず、特定のソースに必要なものだけをロードしてください。
ステップ3: HFコンポジションを生成する
index.htmlを以下の内容で出力します:
- ルートの
<div id="stage">に、コンポジションのdata-composition-id、data-start="0"、data-duration(秒単位)、data-fps、data-width、data-height、およびスカラープロップごとに1つのdata-*属性を持たせます。 data-start/data-duration/data-track-indexを持つシーンdivのフラットリスト。- レイアウト用のインライン
<style>。CSSはアニメーション化されたすべてのプロパティのfrom状態を設定します。 - 一番下にある1つの
<script>タグで、ポーズされたgsap.timeline({paused: true})を含みます。すべてのRemotionのuseCurrentFrame()派生は、このタイムライン上の適切なオフセットでのトゥイーンになります。 window.__timelines["<composition-id>"] = tl;でタイムラインをHFのランタイムに登録します。
カスタムReactサブコンポーネントは、propインターフェースをテンプレートとして使用して、インラインの繰り返しHTMLとして展開します(インスタンスごとのdata-*パターンについてはparameters.mdを参照)。
ステップ4: 検証する
評価ハーネスを実行します — 完全なガイドはreferences/eval.mdを参照。クイックパス:
# Remotionベースラインをレンダリング(フィクスチャでnpm install後)
cd remotion-src && npx remotion render <CompositionId> out/baseline.mp4
# HF変換をレンダリング
cd ../hf-src && npx hyperframes render --skill=remotion-to-hyperframes --output ../hf.mp4
# SSIM差分
../../scripts/render_diff.sh ./remotion-src/out/baseline.mp4 ./hf.mp4 ./diff
しきい値:ソースの複雑度層のp05より約0.02低い値(eval.mdの検証済みしきい値テーブルを参照)。差分が失敗した場合は、scripts/frame_strip.shを実行してどのフレームが乖離したかを確認し、関連するタイミング/シーケンス/メディアリファレンスを再読してください。
重要: 両方のレンダリングで一致するピクセル形式を使用する必要があります。Remotionソースのremotion.config.tsにConfig.setVideoImageFormat("png") + Config.setColorSpace("bt709")を設定してください — そうしないと、差分は変換の忠実度ではなく、エンコーダの違い(約0.05 SSIMの低下)を測定することになります。
ステップ5: ギャップを文書化する
クリーンに変換できなかったもの(ドロップされたボリュームランプ、近似されたカスタムプレゼンテーション、代替されたフォント)は、HF出力の隣にTRANSLATION_NOTES.mdを記述します。フォーマットについてはreferences/limitations.mdを参照してください。
このスキルが明示的に行わないこと
- React状態機械の変換は行いません。
useState+useEffectを介してアニメーションを駆動するコンポジションは、HyperFramesのシーク駆動モデルでは決定論的なフレームキャプチャターゲットではありません。ランタイム相互運用パターンを推奨します。 - HyperFramesと並行してRemotionのレンダリングパイプラインを実行しません。 それはPR #214のランタイム相互運用パターンです — このスキルのリントに失敗するコンポジションのための別のソリューションです。
(@remotion/lambdaはブロッカーではありません — Lambda設定はデプロイメントであり、アニメーションではありません。スキルはそれを警告として削除し、残りを変換します。references/escape-hatch.mdを参照。)
自分の変換を採点する方法
テストコーパスオーケストレーターを実行します:
./assets/test-corpus/run.sh
これはT1、T2、T3(レンダリング + 差分)とT4(リント検証)を実行し、層ごとの合格/不合格テーブルを表示し、集計JSONレポートを出力します。これを使用して、クリーンチェックアウトでスキルがエンドツーエンドで機能していることを確認し、リファレンスを編集した後のリグレッションチェックとしても使用します。
検証済みベースライン(2026-04-27時点):
| 層 | コンポジション形状 | 平均SSIM | しきい値 |
|---|---|---|---|
| T1 | 単一要素のフェードイン | 0.974 | 0.95 |
| T2 | マルチシーン + スプリング + オーディオ + 画像 | 0.985 | 0.95 |
| T3 | データ駆動型、カスタムサブコンポーネント、カウントアップ | 0.953 | 0.90 |
| T4 | エスケープハッチ(8つのリントケース) | 8/8パス | なし |