Communitygithub.com

1345AbhishekKumar/starter-nextjs

기존 Remotion (React) 구성을 HyperFrames HTML로 포팅합니다. 사용자가 명시적으로 Remotion 소스의 포팅/변환/마이그레이션/번역을 요청할 때만 사용합니다.

starter-nextjs란 무엇인가요?

이 스킬은 Remotion(React 기반) 비디오 구성을 HyperFrames(HTML + GSAP) 구성으로 기계적으로 번역합니다. 대부분의 Remotion 관용구(80% 이상)는 직접적인 HyperFrames 대응 표현이 있으며, 나머지 20%는 번역을 거부하거나 런타임 인터롭 패턴을 권장합니다. 주요 지원 플랫폼은 HyperFrames이며, 지원하지 않는 패턴(useState, useEffect, async calculateMetadata, 타사 React 라이브러리, @remotion/lambda)을 플래그로 표시합니다. 번역 과정은 4단계로 진행됩니다: 소스 린트, 번역 계획 수립, HF 구성 생성, 유효성 검사(SSIM 임계값 기준). 사용자가 명시적으로 Remotion에서 마이그레이션을 요청할 때만 사용해야 하며, 새로운 HyperFrames 구성을 작성하거나 다른 프레임워크로 역내보내기, After Effects/Framer Motion 등 비Remotion 소스를 번역하는 용도로는 사용할 수 없습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/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%는 기계적 번역이 가능합니다. 이 스킬은 매핑을 인코딩하고, HF의 seek 기반 모델에 맞지 않는 패턴을 번역하지 않음으로써 손실이 발생하는 20%를 방어하며, 대신 PR #214의 런타임 인터롭 패턴을 권장합니다.

이 스킬은 계층화된 테스트 코퍼스(T1–T4, 총 4개 픽스처)를 제공하며, 측정된 SSIM 임계값을 기준으로 번역을 평가합니다. 평가를 실행하지 않고 번역하지 마세요 — "올바르게 보이는" 번역이라도 검증된 기준선보다 SSIM이 0.05 낮으면 조용히 잘못된 것입니다.

사용 시기

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

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

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

  • (a) 사용자가 유사한 Remotion 비디오를 가지고 있거나 A/B 테스트 중이더라도 새로운 HyperFrames 구성을 작성하는 경우.
  • (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 (비어 있지 않은 deps), 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가 있는 씬 div의 평면 리스트.
  • 레이아웃을 위한 인라인 <style>; CSS는 모든 애니메이션 속성의 from 상태를 설정합니다.
  • 하단에 하나의 <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")를 설정하세요 — 그렇지 않으면 diff가 인코더 차이를 측정하여(약 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 통과n/a

Individual skills in this repo

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

1345AbhishekKumar/starter-nextjs

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-nextjs

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

1345AbhishekKumar/starter-nextjs

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-nextjs

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

관련 스킬