プラグインインストール: セットアップやフレッシュネスコマンドの前に、このスキルが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のシーク駆動モデルに適合しないパターンを翻訳を拒否することで品質低下の20%を防ぎ、代わりにPR #214のランタイム相互運用パターンを推奨します。
このスキルは、階層化されたテストコーパス(T1~T4、合計4つのフィクスチャ)を搭載しており、測定されたSSIMしきい値に対して翻訳を評価します。evalを実行せずに翻訳しないでください — 「見た目は正しい」が検証済みベースラインより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で表現できない場合は辞退してください。
迷ったら/hyperframesに戻ってください。インテントレイヤーがルートを選択します。
ワークフロー
ステップ1: ソースをリントする
Remotionソースディレクトリに対してscripts/lint_source.pyを実行します。リントはクリーンに翻訳できないパターンを検出します:
- ブロッカー(拒否 + 相互運用を推奨):
useState、useReducer、空でないdepsを持つ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はすでにこのルートをclockWipe()/iris()に対してnpx hyperframes add sdf-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のシーク駆動モデルにおける決定論的なフレームキャプチャターゲットではありません。ランタイム相互運用パターンを推奨します。 - 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 |