Communitygithub.com

Remotion to HyperFrames

既存のRemotion(Reactベース)動画コンポジションをHyperFrames(HTML + GSAP)コンポジションに変換します。ユーザーが明示的にRemotionからHyperFramesへの移植、変換、移行を依頼した場合にのみ使用します。

Remotion to HyperFrames とは?

このスキルは、Remotion(Reactベース)の動画コンポジションをHyperFrames(HTML + GSAP)のコンポジションに機械的に変換するための専門ツールです。典型的なコンポジションの約80%は直接的なマッピングで変換可能ですが、HyperFramesのシーク駆動モデルに適合しないパターン(useState、useEffectの副作用、非同期calculateMetadata、サードパーティ製Reactコンポーネントライブラリ、@remotion/lambdaなど)を検出し、変換を拒否してランタイム相互運用エスケープハッチへの誘導を推奨します。スキルはT1〜T4の階層型テストコーパス(4つのフィクスチャ)を搭載し、SSIM(構造的類似度)しきい値に基づいて変換品質を検証します。ワークフローはソースコードのリンティング、変換計画の立案、HyperFrames HTMLの生成、検証、ギャップの文書化の5ステップで構成され、評価ハーネスによる自動回帰テストもサポートしています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/remotion-to-hyperframes

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

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

ドキュメント

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スキルを使用してネイティブの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、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を出力します:

  • コンポジションのdata-composition-id、`data-start=

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

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, and registry discovery.

delorenj/skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

関連スキル