Communitygithub.com

Remotion → HyperFrames 포팅

기존 Remotion(React 기반) 비디오 구성을 HyperFrames HTML 구성으로 변환합니다. 사용자가 명시적으로 Remotion 구성을 HyperFrames로 포팅, 변환, 마이그레이션, 번역 또는 재작성하도록 요청한 경우에만 사용하세요.

Remotion → HyperFrames 포팅란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 Remotion(React 기반) 비디오 구성을 HyperFrames(HTML + GSAP) 구성으로 기계적으로 번역할 수 있도록 설계되었습니다. 일반적인 Remotion 표현식의 약 80%는 직접적인 HyperFrames 대응 항목이 있어 번역이 비교적 간단하지만, 나머지 20%는 상태 관리(useState, useEffect), async calculateMetadata, 타사 React UI 라이브러리, Remotion Lambda 구성 등 번역에 부적합한 패턴이 포함되어 있어 이를 감지하고 대신 '런타임 인터롭(escape hatch)' 패턴을 권장합니다. 이 스킬은 lint 소스 검사, API 매핑 계획, HF 구성 생성, SSIM 기반 시각적 검증, 그리고 번역되지 않은 부분을 문서화하는 5단계 워크플로를 제공합니다. T1~T4 계층화된 테스트 코퍼스와 함께 제공되며, 번역 품질을 측정 가능한 SSIM 임계값으로 평가합니다. 중요한 점은 이 스킬은 사용자가 Remotion -> HyperFrames로의 명시적 마이그레이션을 요청한 경우에만 활성화되며, 새로운 HyperFrames 구성을 작성하거나 Remotion 코드를 단순 참고용으로 공유하는 경우에는 사용되지 않는다는 것입니다.

지원 대상~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의 seek 기반 모델에 부합하지 않는 패턴을 번역하지 않음으로써 손실이 발생하는 20%를 방지하며, 대신 PR #214의 런타임 인터롭 패턴을 권장합니다.

이 스킬은 계층화된 테스트 코퍼스(T1–T4, 총 4개의 fixture)와 함께 제공되며, 측정된 SSIM 임계값에 대해 번역을 평가합니다. 평가를 실행하지 않고 번역하지 마십시오. "올바르게 보이는" 번역이라도 검증된 기준선보다 SSIM이 0.05 낮으면 조용히 잘못된 것입니다.

사용 시기

사용자가 명시적으로 Remotion에서 마이그레이션을 요청한 경우에만 이 스킬을 사용하세요. 예시 트리거 문구:

  • "내 Remotion 프로젝트를 HyperFrames로 포팅해줘"
  • "이 Remotion 코드를 HyperFrames로 변환해줘"
  • "Remotion에서 마이그레이션해줘"
  • "이 Remotion 구성을 번역해줘"
  • "이것을 HyperFrames HTML로 재작성해줘"

다음 경우에는 이 스킬을 사용하지 마세요:

  • (a) 사용자가 유사한 Remotion 비디오를 가지고 있거나 A/B 테스트 중이더라도 새로운 HyperFrames 구성을 작성하는 경우.
  • (b) 사용자가 마이그레이션을 요청하지 않고 Remotion을 우연히 언급하는 경우.
  • (c) 사용자가 번역을 요청하는 것이 아니라 참고 자료로 Remotion 코드를 공유하는 경우.
  • (d) 사용자가 소스 마이그레이션을 명시적으로 요청하지 않고 "내 Remotion 비디오와 동일한 비디오"를 요청하는 경우 — 이는 새로운 HyperFrames 빌드로 처리합니다.

의심스러울 경우 hyperframes 스킬을 사용하여 네이티브 HyperFrames 구성을 작성하는 것이 기본값입니다.

워크플로

1단계: 소스 린트

Remotion 소스 디렉토리에서 scripts/lint_source.py를 실행합니다. 린트는 깔끔하게 번역될 수 없는 패턴을 감지합니다.

  • 차단기 (거부 + 인터롭 권장): useState, useReducer, 비어 있지 않은 deps를 가진 useEffect/useLayoutEffect, async 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 설정은 표준적인 경고 사례입니다. 스킬은 import 및 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="0", data-duration(초 단위), data-fps, data-width, data-height, 스칼라 prop당 하나의 data-*를 포함하는 루트 <div id="stage">.
  • data-start / data-duration / data-track-index가 있는 scene div의 평면 목록.
  • 레이아웃을 위한 인라인 <style>. CSS는 모든 애니메이션 속성의 from 상태를 설정합니다.
  • 하단에 일시 정지된 gsap.timeline({paused: true}) 하나를 포함하는 단일 <script> 태그. 모든 Remotion useCurrentFrame() 파생은 올바른 오프셋에서 이 타임라인의 트윈이 됩니다.
  • window.__timelines["<composition-id>"] = tl;는 타임라인을 HF 런타임에 등록합니다.

사용자 정의 React 하위 구성 요소는 prop 인터페이스를 템플릿으로 사용하여 반복되는 HTML로 인라인됩니다(인스턴스별 data-* 패턴은 parameters.md 참조).

4단계: 검증

평가 도구를 실행합니다. 전체 가이드는 references/eval.md를 참조하십시오. 빠른 경로:

# Remotion 기준선 렌더링 (fixture에서 npm install 후)
cd remotion-src && npx remotion render <CompositionId> out/baseline.mp4

# HF 번역 렌더링
cd ../hf-src && npx hyperframes render --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의 seek 기반 모델에서 결정론적 프레임 캡처 대상이 아닙니다. 런타임 인터롭 패턴을 권장합니다.
  • 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다중 장면 + spring + 오디오 + 이미지0.9850.95
T3데이터 기반, 사용자 정의 하위 구성, 카운트업0.9530.90
T4이스케이프 해치(8개 린트 사례)8/8 통과해당 없음

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.

관련 스킬