Communitygithub.com

Biznomad/claude-skills

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

claude-skills란 무엇인가요?

이 스킬은 Remotion(React 기반) 비디오 컴포지션을 HyperFrames(HTML + GSAP) 컴포지션으로 기계적으로 변환하는 전문 번역 도구입니다. 대부분의 Remotion 관용구(useCurrentFrame, interpolate, spring, Sequence, Audio 등)는 HyperFrames에서 직접적인 대응 관계를 가지며, 약 80%의 일반적인 컴포지션은 손실 없이 변환됩니다. 이 스킬은 변환할 소스 코드를 린트하여 useState, useEffect, async calculateMetadata, 타사 React UI 라이브러리 등 HyperFrames의 탐색 기반(seek-driven) 모델과 맞지 않는 패턴을 감지하고, 손실이 발생하는 변환 대신 런타임 상호 운용성(interop) 패턴을 권장합니다. 또한 계층화된 테스트 코퍼스(T1-T4)를 통해 변환 결과를 SSIM 임계값으로 검증하며, 변환 후 TRANSLATION_NOTES.md를 생성하여 원본과의 차이점을 문서화합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/claude-skills/tree/HEAD/remotion-to-hyperframes

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Remotion에서 HyperFrames로

개요

Remotion (React 기반) 비디오 컴포지션을 HyperFrames (HTML + GSAP) 컴포지션으로 변환합니다. 대부분의 Remotion 관용구는 HyperFrames에서 직접적인 대응 관계를 가지며, 일반적인 컴포지션의 약 80%는 기계적으로 변환됩니다. 이 스킬은 매핑을 인코딩하고, HF의 탐색 기반(seek-driven) 모델에 맞지 않는 패턴은 변환을 거부하고 PR #214의 런타임 상호 운용성 패턴을 대신 권장함으로써 손실이 발생하는 20%를 방지합니다.

이 스킬은 계층화된 테스트 코퍼스(T1–T4, 총 4개 픽스쳐)를 제공하며, 측정된 SSIM 임계값을 기준으로 변환을 평가합니다. 평가를 실행하지 않고 변환하지 마십시오 — "제대로 보이는" 변환이 검증된 기준선보다 0.05 SSIM 낮게 렌더링되면 조용히 잘못된 것입니다.

사용 시기

사용자가 명시적으로 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, 비어 있지 않은 의존성을 가진 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을 출력하십시오:

  • 컴포지션의 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 상태를 설정합니다.
  • 하단에 일시 중지된 gsap.timeline({paused: true})를 포함하는 단일 <script> 태그. 모든 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 --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다중 씬 + spring + 오디오 + 이미지0.9850.95
T3데이터 기반, 사용자 정의 하위 구성 요소, 카운트 업0.9530.90
T4이스케이프 해치 (8개 린트 케이스)8/8 통과해당 없음

Individual skills in this repo

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

Biznomad/claude-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/claude-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/claude-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/claude-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.

Biznomad/claude-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.

Biznomad/claude-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.

Biznomad/claude-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.

Biznomad/claude-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.

Biznomad/claude-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/claude-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/claude-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/claude-skills

Generate cinematic film-style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cinematic, film-like, movie-quality, Hollywood-style, dramatic, or professional film-quality AI video. Triggers on: cinematic, film look, movie scene, dramatic lighting, depth of field, lens flare, anamorphic, letterbox, noir, epic, Steadicam, dolly, crane shot, or any cinematic video generation request. Always use this skill even if the user doesn't explicitly say "cinematic" but describes a film-like aesthetic.

Biznomad/claude-skills

为 Seedance 2.0(Higgsfield)生成电影级胶片风格视频提示词。在用户想要电影级、胶片感、电影质量、好莱坞风格、戏剧性或专业胶片质量的AI视频时使用。触发词:电影级、胶片感、电影场景、戏剧性打光、景深、镜头光晕、变形、信箱式、黑色电影、史诗、稳定摄像机、推车镜头、吊臂镜头或任何电影级视频生成请求。即使用户没有明确说"电影级"但描述了胶片美学,也要使用此技能。

Biznomad/claude-skills

Convert comic book panels, manga pages, webtoons, and illustrated storyboards into animated video using Seedance 2.0 on Higgsfield. Use whenever the user wants to animate comics, bring illustrations to life, convert manga to video, animate storyboards, or create motion from static sequential art. Triggers on: comic to video, manga animation, panel animation, storyboard to video, webtoon animation, comic book motion, sequential art, graphic novel animation, or any illustrate-to-animate request. Use even when user says "make this drawing move" or "animate this page.

Biznomad/claude-skills

Generate music video and beat-synced visual content prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a music video, lyric video, beat-synced visuals, performance video, concert visual, album art animation, or music-driven visual content. Triggers on: music video, lyric video, beat sync, music visualization, performance video, concert visual, album visual, song video, music clip, beat drop visual, rhythm sync, or any music-driven video request. Use even for "make visuals for my song" or "video for this track.

Biznomad/claude-skills

Build, redesign, and deploy websites across any stack — static HTML, Next.js, Astro, or Shopify Liquid themes. Handles design systems, brand-aware layouts, component architecture, and deployment pipelines (Netlify, Vercel, Shopify API). Use when asked to build a website, redesign a site, create a landing page, build a web app, create Shopify sections/templates, or deploy web projects. Triggers on requests like "build me a website", "redesign this page", "create a landing page", "build a Shopify theme", "deploy to Netlify".

Biznomad/claude-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.

관련 스킬