Communitygithub.com

1345AbhishekKumar/starter-supabase — Remotion to HyperFrames

既存のRemotion(React)コンポジションをHyperFramesのHTMLに移植します。ユーザーが明示的にRemotionソースの移植/変換/移行/翻訳を依頼した場合にのみ使用します。

starter-supabase — Remotion to HyperFrames とは?

このスキルは、Remotion(Reactベース)のビデオコンポジションをHyperFrames(HTML + GSAP)のコンポジションに変換するための、一方向かつRemotion専用の翻訳ツールです。ユーザーが明示的に「RemotionからHyperFramesに移植する」などと依頼した場合にのみ使用すべきであり、新しいHyperFramesコンポジションの作成や、After Effects・Framer Motionなど他のツールからの変換には対応しません。スキルはソースコードをリントして、useStateやuseEffect、非同期calculateMetadata、サードパーティ製Reactライブラリなど、HyperFramesのシーク駆動モデルに適合しないパターンを検出し、ブロッカーがあれば変換を拒否してランタイム相互運用パターンを推奨します。変換プロセスは、リント、計画、HFコンポジション生成、検証、ギャップの文書化の5段階で構成され、SSIM閾値による自動評価テストスイート(T1〜T4)が付属しており、翻訳の品質を検証します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/tree/HEAD/.agents/skills/remotion-to-hyperframes

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Remotion から HyperFrames へ

構築前にルートを確認してください。 このスキルは、既存の Remotion(React)コンポジションのソースをHyperFramesに移植するため のみ に使用します。新しい コンポジションを作成する場合(Remotionビデオにインスパイアされたものでも)→ 作成ワークフロー /general-video を使用してください。対象外(一方向、Remotionのみ):逆方向のエクスポート(HyperFrames → Remotion または任意のフレームワーク)はサポートせず、非Remotion ソース(After Effects、Framer Motion、プレーンなReact/CSS)には翻訳元のRemotionソースが存在しないため、/general-video で再作成してください。不明な場合、または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:ソースをリントする

scripts/lint_source.py をRemotionソースディレクトリに対して実行します。リントは、きれいに翻訳できないパターンを検出します:

  • ブロッカー(拒否して相互運用を推奨):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、calculateMetadataparameters.md
Sequence、Series、Loop、AbsoluteFill、Freezesequencing.md
useCurrentFrame、interpolate、spring、Easing、interpolateColorstiming.md
Audio、Video、Img、IFrame、staticFile、delayRendermedia.md
TransitionSeries、@remotion/transitionstransitions.md
@remotion/lottielottie.md
@remotion/google-fonts/<Family>、Font.loadFont、@font-facefonts.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> タグ。これには paused 状態の gsap.timeline({paused: true}) を1つ含めます。すべてのRemotionの useCurrentFrame() 派生は、適切なオフセットでこのタイムライン上のトゥイーンになります。
  • window.__timelines["<composition-id>"] = tl; でタイムラインをHFのランタイムに登録します。

カスタム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.9740.95
T2マルチシーン + スプリング + オーディオ + 画像0.9850.95
T3データ駆動、カスタムサブコンポーネント、カウントアップ0.9530.90
T4エスケープハッチ(8リントケース)8/8 合格n/a

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

1345AbhishekKumar/starter-supabase

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-supabase

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-supabase

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

1345AbhishekKumar/starter-supabase

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

1345AbhishekKumar/starter-supabase

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

1345AbhishekKumar/starter-supabase

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

1345AbhishekKumar/starter-supabase

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

1345AbhishekKumar/starter-supabase

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1345AbhishekKumar/starter-supabase

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

1345AbhishekKumar/starter-supabase

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

1345AbhishekKumar/starter-supabase

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

1345AbhishekKumar/starter-supabase

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-supabase

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

関連スキル