Communitygithub.com

1345AbhishekKumar/starter-nextjs

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

starter-nextjs とは?

このスキルは、Remotion(Reactベース)のビデオコンポジションをHyperFrames(HTML + GSAP)のコンポジションに変換するためのものです。移植プロセスは機械的であり、典型的なコンポジションの約80%は直接的な等価機能を持ちますが、残りの20%については、HyperFramesのシーク駆動モデルに適合しないパターン(useState、useEffect、非同期calculateMetadata、サードパーティReactライブラリ、@remotion/lambdaなど)を翻訳せず、代わりにランタイム相互運用パターンを推奨することで対処します。このスキルは、T1からT4までの階層化されたテストコーパスを備えており、翻訳の品質をSSIM(構造的類似度)しきい値で評価します。翻訳が「正しく見える」だけでは不十分で、検証されたベースラインと比較してSSIMが0.05低い場合は、暗黙のうちに誤りとなります。対応プラットフォームはHyperFramesであり、Remotionからの一方向の移植のみをサポートし、逆方向(HyperFrames→Remotion)やRemotion以外のソース(After Effects、Framer Motionなど)は対象外です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/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 しきい値に対して翻訳を評価します。評価を実行せずに翻訳しないでください。「正しく見える」翻訳でも、検証済みのベースラインよりも 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 で表現できない場合は拒否してください。

不明な場合は、/general-video (一般的な HyperFrames 作成フロー) を使用してネイティブの HyperFrames コンポジションを作成することをデフォルトにしてください。

ワークフロー

ステップ 1: ソースを lint する

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

  • ブロッカー (拒否 + 相互運用を推奨): 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> タグ。これには、一時停止された 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 のランタイム相互運用パターンです — このスキルの lint に失敗するコンポジションのための別のソリューションです。

(@remotion/lambda はブロッカーではありません — Lambda 設定はデプロイメントであり、アニメーションではありません。スキルはそれを警告として削除し、残りを翻訳します。references/escape-hatch.md を参照してください。)

自分の翻訳を評価する方法

テストコーパスオーケストレーターを実行します:

./assets/test-corpus/run.sh

T1、T2、T3 (レンダリング + 差分) と T4 (lint 検証) を実行し、階層ごとの合格/不合格テーブルを出力し、集約された JSON レポートを生成します。これを使用して、クリーンチェックアウトでスキルがエンドツーエンドで機能することを確認し、リファレンスを編集した後の回帰チェックとして使用します。

検証済みベースライン (2026-04-27 現在):

階層コンポジションの形状平均 SSIMしきい値
T1単一要素のフェードイン0.9740.95
T2マルチシーン + spring + オーディオ + 画像0.9850.95
T3データ駆動、カスタムサブコンポーネント、カウントアップ0.9530.90
T4エスケープハッチ (8 つの lint ケース)8/8 合格なし

Individual skills in this repo

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

1345AbhishekKumar/starter-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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.

関連スキル