Communitygithub.com

costa-marcello/skillkit

React에서 Remotion 비디오 개발을 안내합니다. 컴포지션, 애니메이션, 타이밍, 오디오, 캡션, 렌더링 등을 다룹니다. 사용자가 Remotion으로 작업하거나, <Composition>/<Sequence>/interpolate/spring을 작성하거나, remotion.config.ts를 편집하거나, Lambda 비디오를 렌더링/배포하거나, React에서 비디오 제작에 대해 질문할 때 사용하세요.

skillkit란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 Remotion 기반 React 비디오 프로젝트를 전체적으로 안내하는 전문 가이드 역할을 합니다. 프로젝트 스캐폴딩부터 최종 렌더링까지 모든 단계에서 활용할 수 있으며, 흔한 실수를 방지하는 8가지 핵심 규칙(예: 비결정적 난수 사용 금지, `delayRender` 누락 방지, 캡션 `inputRange` 단조 증가 보장 등)을 제공합니다. 다양한 주제별로 세분화된 규칙 파일(핵심, 미디어, 오디오, 텍스트, 고급, 유틸리티, 프로덕션, 통합, 패키지)을 참조하여 구체적인 코드 예제와 설정 방법을 확인할 수 있습니다. 이 스킬은 새 프로젝트 생성(npx create-video), 스튜디오 미리보기(npx remotion studio), 단일 프레임 렌더링을 통한 검증 등 CLI 명령어를 지원하며, Remotion 5.x의 새로운 trimBefore/trimAfter API를 올바르게 사용하는 방법을 강조합니다. 또한 @remotion/google-fonts, @remotion/player, @remotion/lambda 등 주요 패키지 사용법과 Next.js, Docker와의 통합, 성능 최적화, HDR 출력 등의 고급 주제를 포괄적으로 다룹니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/costa-marcello/skillkit/tree/HEAD/skills/remotion-video

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

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

문서

사용 시기

이 스킬은 프로젝트 스캐폴딩부터 최종 비디오 렌더링에 이르기까지 Remotion 코드를 읽거나 작성할 때마다 불러오세요.

피해야 할 일반적인 AI 실수

커밋하기 전에 모든 Remotion 코드 변경 사항에 대해 다음의 반복적인 실패 패턴을 확인하세요:

  • 비결정적 무작위성 — remotion의 random(seed)를 사용하고, Math.random(), Date.now(), new Date()는 절대 사용하지 마세요. 그렇지 않으면 병렬 렌더 시 지글거리는 노이즈가 발생합니다.
  • 메모이즈되지 않은 <Player> inputProps — 항상 메모이즈된 props를 전달하세요. 메모이즈되지 않은 props는 전체 트리에 리렌더링 폭풍을 일으킵니다.
  • 비동기 작업(fetch, 폰트 로드, 측정) 시 delayRender() / continueRender() 누락 — 이를 생략하면 렌더가 30,000ms에서 중단됩니다.
  • 캡션의 inputRange가 단조 증가하지 않음 — interpolate의 inputRange는 반드시 엄격하게 증가해야 합니다. 짧은 클립의 경우 페이드 윈도우에 Math.min(10, Math.floor(duration / 3))을 사용하세요.
  • 모든 곳에서 선형 이징 사용 — 자연스러운 움직임에는 spring()을 선호하고, 명시적인 기술적 필요가 있을 때만 선형을 사용하세요.
  • @remotion/google-fonts 가져오기 누락 — 모든 폰트는 명시적인 loadFont({ weights, subsets }) 호출이 필요합니다.
  • 단일 컴포지션으로 모든 출력 — 장면을 작고 집중된 컴포지션으로 나누고 <Sequence> 또는 <TransitionSeries>로 구성하세요.
  • 더 이상 사용되지 않는 startFrom / endAt — 대신 trimBefore / trimAfter를 사용하세요.

새 프로젝트 설정

빈 폴더나 기존 Remotion 프로젝트가 없는 작업 공간인 경우, 다음을 사용하여 프로젝트를 스캐폴딩하세요:

npx create-video@latest --yes --blank --no-tailwind my-video

my-video를 적절한 프로젝트 이름으로 바꾸세요.

미리보기 시작

비디오를 미리 보려면 Remotion Studio를 시작하세요:

npx remotion studio

선택 사항: 단일 프레임 렌더 확인

CLI로 단일 프레임을 렌더링하여 레이아웃, 색상 또는 타이밍을 점검할 수 있습니다. 단순한 편집, 순수 리팩터링, 또는 Studio나 이전 렌더에서 충분한 확신이 있는 경우에는 건너뛰세요.

npx remotion still [composition-id] --scale=0.25 --frame=30

30fps에서 --frame=30은 1초 지점입니다(--frame은 0부터 시작).

규칙 인덱스

자세한 설명과 코드 예제는 개별 규칙 파일을 읽으세요.

핵심(Core)

미디어(Media)

오디오(Audio)

텍스트(Text)

고급(Advanced)

유틸리티(Utilities)

프로덕션(Production)

통합(Integration)

패키지(Packages)

  • packages/paths.md - @remotion/paths SVG 경로 유틸리티(interpolatePath, warpPath, getLength)
  • packages/shapes.md - @remotion/shapes 사전 빌드된 SVG 프리미티브(삼각형, 원, 별, 파이, 하트)
  • packages/noise.md - @remotion/noise 시드 기반 펄린 노이즈(noise2D, noise3D, noise4D)
  • packages/motion-blur.md - @remotion/motion-blur Trail 및 CameraMotionBlur(제한적으로 사용)
  • packages/skia.md - @remotion/skia 고성능 캔버스(React Native Skia)
  • packages/rive.md - @remotion/rive 상태 머신 애니메이션(Lottie 대체)

관련 스킬