Communitygithub.com

Aseel1600/Edit01

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

Edit01 とは?

このスキルは、Remotion(Reactベース)のビデオコンポジションをHyperFrames(HTML + GSAP)のコンポジションに変換するための専用ツールです。RemotionのAPI(useCurrentFrame、Sequence、Audio、Videoなど)をHyperFramesの同等機能に機械的にマッピングし、約80%の典型的なコンポジションを自動翻訳します。ただし、useState/useEffectによる状態駆動型アニメーションや非同期calculateMetadataなど、HyperFramesのシーク駆動モデルに適合しないパターン(損失の大きい20%)は拒否し、代わりにランタイム相互運用パターンを推奨します。変換は一方向(Remotion→HyperFramesのみ)で、逆方向のエクスポートや非Remotionソース(After Effects、Framer Motionなど)の変換はサポートしません。検証用のテストコーパス(T1〜T4)が付属しており、SSIM閾値に基づいて翻訳の品質を評価します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Aseel1600/Edit01/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%は機械的な翻訳が可能です。このスキルはマッピングをエンコードし、損失の大きい20%については、HF のシーク駆動モデルに適合しないパターンの翻訳を拒否し、代わりに PR #214 のランタイム相互運用パターンを推奨することで防御します。

このスキルには、階層化テストコーパス(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: ソースを検査する

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、およびスカラー prop ごとに1つの data-* を含めます。
  • data-start / data-duration / data-track-index を持つシーン div のフラットリスト。
  • レイアウト用のインライン <style>。CSS はすべてのアニメーションプロパティの from 状態を設定します。
  • 最後に1つの <script> タグ。これには1つの一時停止された gsap.timeline({paused: true}) が含まれます。すべての Remotion useCurrentFrame() の派生は、適切なオフセットでこのタイムライン上のトゥイーンになります。
  • window.__timelines["<composition-id>"] = tl; は、タイムラインを HF のランタイムに登録します。

カスタム React サブコンポーネントは、prop インターフェースをテンプレートとして使用して、インラインで繰り返し 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 合格n/a

Individual skills in this repo

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

Aseel1600/Edit01

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

Aseel1600/Edit01

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Aseel1600/Edit01

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Aseel1600/Edit01

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Aseel1600/Edit01

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Aseel1600/Edit01

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Aseel1600/Edit01

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Aseel1600/Edit01

Generate expressive, multilingual narration with fish.audio (S1 / S2-generation models) and reuse cloned voices via reference_id. Use when the user prefers fish.audio/Fish Audio TTS, wants a specific playground voice model, or needs high-emotion voice-clone narration.

Aseel1600/Edit01

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Aseel1600/Edit01

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.

Aseel1600/Edit01

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`).

Aseel1600/Edit01

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.

Aseel1600/Edit01

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`.

Aseel1600/Edit01

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.

Aseel1600/Edit01

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).

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Aseel1600/Edit01

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

関連スキル