最初に、このスキルを最新の状態に保ってください — ユーザーに確認してから実行:
npx hyperframes skills update remotion-to-hyperframes。すべてが最新の場合は高速な no-op です。それ以外の場合は、このスキルと、それが依存するコアドメインスキルを、それらに依存する前に更新します。
Remotion から 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 |
すべてをロードしないでください — 特定のソースが必要とするものだけをロードしてください。
テーブルにマッピングされていない視覚効果については、ライブカタログを検索してください。 ソースが HF API に同等のものがないルック(スキャンライン/CRT オーバーレイ、グリッチまたは色収差パス、シェーダーワイプ、フィルムグレイン処理)をペイントする場合は、GSAP で手書きする前に npx hyperframes catalog --query "<エフェクトを平易な英語で>" --json を実行してください。この検索には 何もインストールする必要はありません:プロジェクト、事前の add、アカウントは必要ありません。任意のディレクトリからホストされているレジストリ全体 (~400 ブロックとコンポーネント) をランク付けします。transitions.md はすでに npx hyperframes add sdf-iris を介して clockWipe() / iris() に対してこのルートを取っています。実際のコンポーネントは手書きの近似値よりもソースに近いため、通常は SSIM を下げるのではなく上げます — ただし、ステップ 4 のレンダリング差分が依然として判断基準です。検索で適切なものが見つからなかった場合は、エフェクトを手書きし、代わりに TRANSLATION_NOTES.md に置換を記録します。
ステップ 3: HF コンポジションを生成する
index.html を以下の内容で出力します:
- ルート
<div id="stage">は、コンポジションのdata-composition-id、data-start="0"、data-duration(秒単位)、data-fps、data-width、data-height、およびスカラープロパティごとに 1 つのdata-*を持ちます。 - シーンごとに 1 つのホスト
<div>で、data-composition-src="compositions/<scene>.html"とdata-start/data-duration/data-track-indexを持ちます。ルートはネストされたレイアウトを保持しません。 - シーンごとに 1 つの
compositions/<scene>.html(<template>サブコンポジション):レイアウト用のインライン<style>(CSS はすべてのアニメーションプロパティのfrom状態を設定します)、マークアップ、およびシーンのローカル時間内の 1 つの一時停止されたgsap.timeline({paused: true})。すべての RemotionuseCurrentFrame()の派生は、シーン内のオフセットでそのタイムライン上のトゥイーンになります。 - 各シーンファイル内の
window.__timelines["<scene-id>"] = tl;、およびルート自身の(空の可能性がある)タイムライン用のwindow.__timelines["<composition-id>"]。
カスタム React サブコンポーネントは、プロップインターフェースをテンプレートとして使用して(インスタンスごとの data-* パターンについては parameters.md を参照)、繰り返し HTML としてインライン化します。
ステップ 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 合格 | n/a |