プラグインインストール: セットアップやフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合はプラグインインストールルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持してください。
最初に、このスキルを最新の状態に保ってください — ユーザーに確認してから実行:
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しきい値に対して翻訳を評価します。評価を実行せずに翻訳しないでください — 「見た目は正しい」が、検証済みベースラインよりもSSIMが0.05低いレンダリングは、静かに間違っています。
使用する場合
ユーザーが明示的に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で表現できない場合は辞退してください。
迷った場合は、/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。
ブロッカーが1つでも発生した場合は停止してください。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サブコンポーネントは、プロップインターフェースをテンプレートとして使用して、インラインで繰り返し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のシーク駆動モデルにおける決定論的なフレームキャプチャターゲットではありません。ランタイム相互運用パターンを推奨します。 - RemotionのレンダリングパイプラインをHyperFramesと並行して実行しません。 それは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 | マルチシーン + spring + オーディオ + イメージ | 0.985 | 0.95 |
| T3 | データ駆動型、カスタムサブコンポーネント、カウントアップ | 0.953 | 0.90 |
| T4 | エスケープハッチ(8つのリントケース) | 8/8合格 | n/a |