Communitygithub.com

Biznomad/agent-skills

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

agent-skills란 무엇인가요?

이 스킬은 Remotion 비디오 컴포지션을 HyperFrames(HTML + GSAP) 컴포지션으로 기계적으로 변환하는 맵핑을 제공합니다. 대부분의 Remotion 관용구(약 80%)는 직접적인 HyperFrames 대응을 가지나, useState, useEffect, 비동기 calculateMetadata, 서드파티 React 컴포넌트 라이브러리, @remotion/lambda 등 HyperFrames의 시크 기반 모델에 맞지 않는 패턴은 감지하여 번역을 거부하고 대신 런타임 인터롭 이스케이프 해치를 권장합니다. 이 스킬은 계층화된 테스트 코퍼스(T1-T4, 총 4개 픽스처)와 함께 제공되어 SSIM 임계값을 기준으로 번역 품질을 평가하며, 변환 후 평가를 실행하지 않으면 '올바르게 보이는' 번역이라도 무음 실패할 수 있습니다. 주로 Claude Code, Cursor, Codex와 같은 AI 에이전트에서 Remotion 프로젝트를 HyperFrames로 체계적으로 마이그레이션할 때 사용됩니다.

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

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

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

문서

Remotion to HyperFrames

개요

Remotion (React 기반) 비디오 컴포지션을 HyperFrames (HTML + GSAP) 컴포지션으로 변환합니다. 대부분의 Remotion 관용구는 직접적인 HyperFrames 대응을 가지며, 일반적인 컴포지션의 약 80%는 기계적으로 변환 가능합니다. 이 스킬은 이러한 맵핑을 인코딩하고, 손실이 발생하는 20%에 대해 HF의 시크 기반 모델에 맞지 않는 패턴의 번역을 거부하고 대신 PR #214의 런타임 인터롭 패턴을 권장합니다.

이 스킬은 계층화된 테스트 코퍼스 (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 스킬을 사용하여 기본 HyperFrames 컴포지션을 작성하는 것이 기본값입니다.

워크플로

1단계: 소스 린트

Remotion 소스 디렉터리에서 scripts/lint_source.py를 실행합니다. 린트는 깔끔하게 변환할 수 없는 패턴을 감지합니다:

  • 블로커 (거부 + 인터롭 권장): useState, useReducer, 비어 있지 않은 deps를 가진 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 설정은 표준 경고 사례입니다. 스킬은 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 상태를 설정합니다.
  • 하단에 일시 중지된 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다중 장면 + 스프링 + 오디오 + 이미지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.

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-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/agent-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/agent-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/agent-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/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-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/agent-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/agent-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/agent-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/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-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/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-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/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

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

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

관련 스킬