Communitygithub.com

thevibethinker/n5os-ode

React로 Remotion을 사용해 프로그래매틱 영상을 제작합니다. 프로젝트 스캐폴딩, 컴포지션 작성, MP4 렌더링까지 지원하는 Zo 최적화 공식 Remotion 에이전트 스킬입니다.

n5os-ode란 무엇인가요?

이 스킬은 React 기반 프로그래매틱 비디오 제작 도구인 Remotion을 손쉽게 사용할 수 있도록 도와주는 Zo 최적화 래퍼입니다. 사용자는 CLI 명령어를 통해 새 프로젝트를 생성하고, React 컴포넌트로 영상의 모든 프레임을 정의하며, `useCurrentFrame()` 기반의 프레임 단위 애니메이션을 구현할 수 있습니다. 스튜디오에서 실시간 미리보기를 확인한 후 MP4, H.264, ProRes 등 다양한 코덱으로 고품질 렌더링이 가능합니다. 특히 데이터 기반 영상, 소셜 미디어 숏폼, 개인화된 배치 영상 제작에 최적화되어 있으며, CSS 애니메이션 대신 Remotion의 프레임 기반 패턴(인터폴레이션, 스프링, 시퀀스)을 강제합니다. Zo와 통합되어 `/zo/ask`를 통해 여러 영상을 병렬 렌더링하거나 템플릿 기반 배치 처리를 수행할 수 있습니다. Node.js 환경이 필요하며, Zo 시스템 내에서 이미 제공됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thevibethinker/n5os-ode/tree/HEAD/Skills/remotion

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

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

문서

사용 시기

다음과 같은 경우 이 스킬을 사용하세요:

  • 코드로 프로그래매틱 영상 만들기 (생성형 AI 영상이 아님)
  • 데이터 기반 영상 콘텐츠 제작 (차트, 통계, 개인화 영상)
  • 템플릿 + 데이터로 영상 일괄 제작
  • 애니메이션 소셜 콘텐츠 (TikTok, Reels, Shorts) 만들기
  • 정밀 제어가 필요한 제품/설명 영상 만들기

빠른 시작

1. 새 프로젝트 만들기

python3 Skills/remotion/scripts/remotion_cli.py new my-video --template blank
cd Sites/my-video

2. 컴포지션 작성하기

src/Composition.tsx 파일을 편집하세요. 이 파일이 React 컴포넌트로 정의된 영상입니다.

3. 스튜디오에서 미리보기

python3 Skills/remotion/scripts/remotion_cli.py studio my-video

4. MP4로 렌더링

python3 Skills/remotion/scripts/remotion_cli.py render my-video --output output.mp4

핵심 개념

컴포지션

컴포지션은 영상의 해상도, 길이, FPS를 정의합니다:

<Composition
  id="MyVideo"
  component={MyComponent}
  durationInFrames={300}  // 30fps 기준 10초
  fps={30}
  width={1920}
  height={1080}
/>

프레임 기반 애니메이션

모든 애니메이션은 반드시 useCurrentFrame()을 사용해야 합니다. CSS 애니메이션은 금지됩니다.

const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });

시퀀스

<Sequence>를 사용해 요소가 나타나는 타이밍을 조절합니다:

<Sequence from={30} durationInFrames={60}>
  <Title />
</Sequence>

규칙 참조

자세한 패턴은 다음 파일들을 참조하세요 (상위 Remotion 스킬에서 로드됨):

규칙설명
references/animations.md프레임 기반 애니메이션 기본
references/timing.md스프링, 이징, 보간 곡선
references/compositions.md컴포지션, 스틸, 폴더 정의
references/sequencing.md요소 타이밍 및 순서 지정
references/videos.md비디오 임베딩 - 트림, 볼륨, 속도
references/audio.md오디오 처리 - 가져오기, 트림, 볼륨
references/assets.md이미지, 폰트, 정적 파일
references/transitions.md장면 전환
references/text-animations.md타이포그래피 애니메이션 패턴
references/charts.md데이터 시각화 패턴
references/display-captions.mdTikTok 스타일 자막

CLI 명령어

# 프로젝트 관리
python3 Skills/remotion/scripts/remotion_cli.py new <이름> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <이름>
python3 Skills/remotion/scripts/remotion_cli.py render <이름> [--composition ID] [--output 경로]
python3 Skills/remotion/scripts/remotion_cli.py list

# 렌더링 옵션
--composition ID    # 렌더링할 특정 컴포지션 (기본값: 첫 번째)
--output PATH       # 출력 파일 경로 (기본값: out/video.mp4)
--fps N             # FPS 재정의
--width N           # 너비 재정의
--height N          # 높이 재정의
--codec CODEC       # h264, h265, vp8, vp9, prores (기본값: h264)

일반 패턴

페이드 인/아웃

const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();

const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;

스프링 애니메이션 (자연스러운 움직임)

const scale = spring({
  frame,
  fps,
  config: { damping: 200 }, // 부드럽고 바운스 없음
});

요소 지연 등장

{items.map((item, i) => (
  <Sequence key={i} from={i * 10}>
    <Item data={item} />
  </Sequence>
))}

데이터 기반 영상

type VideoProps = { title: string; stats: number[] };

export const DataVideo: React.FC<VideoProps> = ({ title, stats }) => {
  // props 기반 애니메이션
};

// Root.tsx:
<Composition
  id="DataVideo"
  component={DataVideo}
  defaultProps={{ title: "Q4 실적", stats: [10, 20, 30] }}
  // ...
/>

Zo와의 통합

일괄 렌더링

/zo/ask를 사용해 여러 영상을 병렬 렌더링합니다:

for row in data:
    # 각 호출은 다른 props로 렌더링
    await render_video(row)

출력 위치

프로젝트는 Zo의 사이트 시스템과 일관성을 위해 Sites/<프로젝트명>/에 저장됩니다. 렌더링된 영상은 Sites/<프로젝트명>/out/에 출력됩니다.

제약 사항

  • CSS 애니메이션 없음 - 올바르게 렌더링되지 않습니다
  • Tailwind 애니메이션 클래스 없음 - 같은 문제
  • 프레임 기반만 가능 - 모든 움직임은 useCurrentFrame()에서 비롯되어야 함
  • CPU 집약적 - 렌더링에 시간이 걸리며 복잡한 영상일수록 더 오래 걸림
  • Node.js 필요 - Remotion은 Node 환경을 필요로 함 (Zo에 이미 포함됨)

관련 스킬