Communitygithub.com

AlessandroFare/fluxychat

既存のRemotion(React)コンポジションのソースをHyperFrames HTMLに移植します。明示的な移植・変換・移行の要請がある場合にのみ使用してください。

fluxychat とは?

このスキルは、Remotion(Reactベース)のビデオコンポジションをHyperFrames(HTML + GSAP)のコンポジションに一方向で変換するためのものです。ほとんどのRemotionのイディオムはHyperFramesに直接対応しており、典型的なコンポジションの約80%は機械的に変換できます。ただし、Reactの状態管理(useState, useEffect, useReducer)などのパターンは変換できないため、それらを検出するリンターが実行され、ブロッカーが検出された場合はランタイム相互運用パターンを推奨します。変換後は、SSIM(構造的類似度)測定による検証が必須であり、評価ハーネスを使用して変換の忠実度を確認します。このスキルは、Claude CodeなどのAIエージェントで使用するために設計されており、明示的にRemotionからの移行を求められた場合にのみ起動されます。

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

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

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

ドキュメント

まず、このスキルを最新に保つために、確認なしで実行してください: 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のシーク駆動モデルに適合しないパターンの変換を拒否し、代わりに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: ソースをリントする

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

ブロッカーが発生した場合は停止してください。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})を含みます。すべての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のシーク駆動モデルでは決定論的なフレームキャプチャターゲットではありません。ランタイム相互運用パターンを推奨します。
  • 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.9740.95
T2マルチシーン + スプリング + オーディオ + 画像0.9850.95
T3データ駆動型、カスタムサブコンポーネント、カウントアップ0.9530.90
T4エスケープハッチ(8つのリントケース)8/8パスなし

Individual skills in this repo

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

AlessandroFare/fluxychat

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.\n

AlessandroFare/fluxychat

Use when audio already placed in a HyperFrames composition needs to be mixed: a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.\n

AlessandroFare/fluxychat

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.\n

AlessandroFare/fluxychat

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

AlessandroFare/fluxychat

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.\n

AlessandroFare/fluxychat

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

AlessandroFare/fluxychat

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

AlessandroFare/fluxychat

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlessandroFare/fluxychat

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

AlessandroFare/fluxychat

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

AlessandroFare/fluxychat

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

AlessandroFare/fluxychat

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

AlessandroFare/fluxychat

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

AlessandroFare/fluxychat

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

AlessandroFare/fluxychat

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

AlessandroFare/fluxychat

Design and improve user interfaces using the concrete rules from Refactoring UI (Wathan & Schoger) — constrained spacing/type/color/shadow scales, visual hierarchy through weight and color rather than size, and depth through emulated light. Use when building or styling any UI (web, app, dashboard, landing page, component), when picking font sizes, spacing, colors, shadows or border radius, when designing a color palette or design tokens, and whenever someone says a UI "looks off", "looks amateur", "feels cluttered/plain/unfinished", or asks to "make this look better".

AlessandroFare/fluxychat

Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.

関連スキル