Communitygithub.com

remotion-video

아이디어를 Remotion을 사용해 내레이션이 포함된 세로형 짧은 동영상(1080x1920 MP4)으로 만들어 줍니다. 대본을 작성하고, ElevenLabs로 음성 및 단어 타이밍을 생성하며, 다섯 가지 장면 유형, 단어별 자막, 입모양이 맞춰진 마스코트가 포함된 스타터 프로젝트를 렌더링합니다.

remotion-video란 무엇인가요?

이 스킬은 사용자의 아이디어를 Remotion 기반의 짧은 소셜 미디어 동영상(세로형, 1080x1920)으로 제작해 주는 도구입니다. 사용자가 동영상 주제, 대상 시청자, 채널 이름만 제공하면, 스킬이 자동으로 4~7개 장면의 대본을 작성하고 ElevenLabs API를 통해 음성과 단어별 타임스탬프를 생성합니다. 생성된 음성과 타이밍 데이터를 Remotion 프로젝트에 통합하여 다섯 가지 장면 유형(hook, point, stat, bars, cta)과 단어 단위 자막, 입모양 동기화 마스코트를 포함한 최종 MP4 파일을 렌더링합니다. Claude Code, Cursor 등의 터미널 기반 AI 에이전트에서 실행되며, 사용자가 "/remotion-video" 명령을 내리거나 "X에 대한 동영상 만들어 줘", "쇼츠/릴스/틱톡 만들어 줘" 같은 요청을 할 때 사용됩니다. 렌더링 전에 각 장면의 스틸 이미지를 확인하여 텍스트가 화면에 적절히 배치되었는지 검증하며, 최종 결과물의 길이, 파일 크기 및 저장 위치를 사용자에게 알려줍니다.

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

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

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

문서

remotion-video은(는) 무엇을 하나요?

사용자의 아이디어를 입력받아 MP4 파일을 반환합니다. 이 파일 옆에 있는 키트가 실제 작업을 수행합니다: kit/new-video.sh가 프로젝트를 생성하고, narrate.py가 대본을 오디오와 타이밍으로 변환하며, Remotion 프로젝트가 이를 렌더링합니다.

이 파일 옆에 kit 폴더가 없다면, 스킬이 복사되면서 누락된 것입니다. https://github.com/anujkapoor-arch/video-skills 저장소를 클론하고 해당 kit 폴더를 사용하세요.

시작하기 전에

다음 항목들을 확인하고, 누락된 항목이 있으면 명확한 메시지와 함께 중단하세요:

  • node --version, python3 --version, ffmpeg -version. 이 키트는 Node 24, Python 3, ffmpeg 8에서 테스트되었습니다.
  • 환경 변수에 ELEVENLABS_API_KEY가 설정되어 있거나, 사용자가 프로젝트의 .env 파일에 직접 추가할 준비가 되어 있어야 합니다. 무음 또는 무료 모드는 없습니다. 키를 출력하거나 커밋하지 마세요.
  • Remotion 라이선스. 개인 및 최대 3명 직원의 기업은 무료입니다. 더 큰 기업은 유료 Company License(remotion.dev/docs/license)가 필요합니다. 사용자에게 한 번 알려주세요. Remotion이 적합하지 않다면 MIT 라이선스인 revideo-video 스킬을 사용하세요.

단계

1. 아이디어를 대본으로 만들기

추론할 수 없는 내용만 물어보세요: 주제, 대상 시청자, 채널 이름. 그런 다음 대본은 직접 작성하세요.

  • 47개의 장면, 총 2045초 분량. 사람은 초당 약 2.5단어를 말합니다.
  • hook으로 시작하고 cta로 끝냅니다. 중간에 points, stat, bars를 사용하세요.
  • 각 say는 한두 개의 짧은 문장으로, 듣기 편하게 작성하세요. 숫자는 단어로 표기하세요.
  • 화면에 표시되는 모든 숫자는 사용자가 제공했거나 이름을 밝힐 수 있는 출처가 있어야 합니다. 출처가 없으면 물어보세요. 절대 통계를 지어내지 마세요.
  • 각 항목에 큐 워드(at)를 선택하여 시각 자료가 음성의 특정 단어에 맞춰지도록 하세요.

전체 필드 목록은 kit/common/SCRIPT.md에 있습니다. 대본을 작성하기 전에 이 파일을 읽으세요.

2. 프로젝트 생성하기

<이 스킬의 폴더>/kit/new-video.sh remotion <새-폴더>
cd <새-폴더>
npm install

npm install은 약 20초 정도 걸립니다. 첫 번째 렌더링 시 node_modules에 Chrome Headless Shell(약 470MB)도 다운로드합니다.

3. script.json 작성, 확인 후 음성 비용 지불

예제 script.json을 사용자의 대본으로 대체한 후:

python3 narrate.py --check    # 유효성 검사 후 문자 수 출력, API 호출 없음

사용자에게 음성 대사와 문자 수를 보여주고, 다음 명령을 실행하기 전에 동의를 받으세요. ElevenLabs는 문자당 비용을 청구합니다.

python3 narrate.py            # public/narration.wav 및 src/spec.json 생성

각 장면의 시작 시간과 길이를 출력합니다. 대사는 .tts-cache/에 캐시되므로, 편집 후 다시 실행해도 변경된 대사에 대해서만 비용이 청구됩니다.

4. 전체 렌더링 전에 스틸 이미지 확인하기

스틸 이미지 하나는 약 4초, 전체 렌더링은 동영상 길이만큼 걸립니다.

npx remotion still src/index.ts Video out/check.png --frame=150

프레임 = 초 x 30입니다. 각 장면 내에서 마지막 큐 이후 약 1초 지점에 스틸 이미지 하나를 렌더링하여 확인하세요. 텍스트가 카드에 잘 맞고, 캡션이나 마스코트와 겹치는 부분이 없으며, y=1620 아래(쇼츠/릴스 UI가 덮는 영역)에 중요한 내용이 없는지 확인하세요.

5. 렌더링

npm run render                # -> out/video.mp4
npm run studio                # 선택 사항: 타임라인과 핫 리로드로 미리보기

6. 결과 보고

파일에 대해 ffprobe를 실행하고 사용자에게 길이, 크기 및 위치를 알려주세요. 확인한 사항(스틸 이미지)과 확인하지 않은 사항(오디오 청취 또는 모션 확인 불가)을 말씀드리세요. 사용자에게 소리를 켜고 한 번 시청해 달라고 요청하세요.

변경하기

변경 사항수정 위치
색상, 채널 이름, 푸터, 캡션 켜기/끄기, 마스코트 켜기/끄기script.json을 수정한 후 python3 narrate.py 실행(무료, 오디오는 캐시됨)
음성script.json의 voice.id 또는 ELEVENLABS_VOICE_ID 환경 변수. 새 음성은 모든 대사에 대해 다시 비용이 청구됩니다.
폰트.ttf 파일을 public/fonts/에 넣고, src/fonts.ts에 등록한 후 src/util.ts의 FONT를 변경
장면 유형 레이아웃src/scenes.tsx의 해당 컴포넌트
헤더, 카드, 캡션, 말풍선, 종이폭죽src/Video.tsx
마스코트src/Mascot.tsx

장면 종류 추가하기

  1. {s: Scene}을 입력으로 받고 내용을 <Layer s={s}>로 감싸는 컴포넌트를 src/scenes.tsx에 작성합니다.
  2. 동일 파일 하단의 KINDS와 src/util.ts의 kind 유니온에 추가합니다.
  3. narrate.py의 KINDS에 필수 필드와 함께 추가합니다.

마스코트 교체하기

캐릭터의 SVG를 src/Mascot.tsx로 JSX 형태로 포팅하세요. .svg 파일을 직접 로드하지 마세요. 프레임별로 구동되는 다섯 가지 요소를 유지하세요: open에 따른 입 높이, blink에 따른 눈 scaleY, 동공 오프셋, 눈썹 오프셋, 기울어지는 머리 그룹. 나중에 SVG가 변경되면 포팅을 다시 해야 합니다.

Remotion 렌더링을 올바르게 유지하는 규칙

  • 화면의 모든 것은 현재 프레임의 함수여야 합니다. useState, CSS 전환, setTimeout, Math.random()을 사용하지 마세요. Remotion은 프레임을 병렬로 그리고 순서에 상관없이 렌더링하므로, 메모리를 사용하는 모든 것은 오작동합니다. remotion의 random(seed)를 사용하세요.
  • 모든 타이밍은 spec.json에서 가져옵니다. 시간을 초 단위로 하드코딩하지 마세요. s.start, item.t 또는 단어의 t를 읽어서 새로운 내레이션이 코드 변경 없이 비디오 타이밍을 다시 조정할 수 있게 하세요.
  • 폰트는 src/fonts.ts에서 delayRender 뒤에 로드됩니다. 그렇지 않으면 폰트가 준비되기 전에 프레임이 캡처될 수 있습니다.
  • 브라우저가 렌더링 시점에 로드하는 파일(오디오, 폰트, 이미지)은 public/에 있으며 staticFile()로 참조됩니다.
  • HTML은 긴 텍스트를 줄 바꿈하지만 크기를 줄이지는 않습니다. 스타터는 문자 수에 따라 폰트 크기를 선택합니다. 텍스트를 추가하는 경우에도 동일하게 처리하지 않으면 카드를 넘칠 수 있습니다.
  • 스프링은 spring({frame: frame - at * fps, fps, config})입니다. util.ts의 pop() 헬퍼가 이를 감쌉니다.
  • 립싱크는 단어 타이밍(util.ts의 mouthOpen)에서 비롯되며, 오디오 분석은 사용하지 않습니다.
  • 동영상 길이는 전체 프레임으로 반올림되므로, MP4는 spec.total보다 최대 1/30초 더 길 수 있습니다.

테스트 머신(Apple M2, 8GB RAM)의 수치

  • 25초 동영상: 렌더링 26.5초, 파일 크기 4.9MB.
  • node_modules: 설치 후 240MB, 첫 렌더링 후 약 950MB(Chrome Headless Shell 및 webpack 캐시 포함).

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬