What problem does it solve?
Translates Remotion (React-based) video compositions into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. port my Remotion project to HyperFrames). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants the same video as my Remotion one without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the hyperframes skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, remotion/lambda) and recommends the runtime interop escape hatch instead of a lossy translation.
Core Features & Use Cases
- Lint the Remotion source to detect blockers (useState, useEffect with non-empty deps, lambda configs) and surface warnings for exacerbating translation gaps.
- Plan the translation by mapping Remotion APIs to HyperFrames equivalents using a reference map and selecting required references per topic.
- Generate a HyperFrames HTML composition with staged timelines, data attributes, and inline styles for deterministic playback.
- Validate translations against a test harness, compare SSIM to a baseline, and document any translation gaps in TRANSLATION_NOTES.md.
Quick Start
Run the Remotion-to-HyperFrames workflow on a Remotion project to generate a HyperFrames-ready HTML composition.