script-to-remotion
구조화된 비디오 스크립트를 실행 가능한 Remotion 프로젝트로 변환합니다. 여기에는 React 컴포넌트 생성, TTS 오디오 통합, 자막 생성 및 비디오 렌더링이 포함됩니다.
사용 시나리오
다음과 같은 경우 이 스킬을 사용하세요:
- script.json을 Remotion 비디오 프로젝트로 변환해야 할 때
- remotion-best-practices를 준수하는 React 컴포넌트를 생성할 때
- (선택 사항) Google Gemini API를 사용하여 TTS 오디오를 생성할 때
- 지능적으로 분할된 자막을 자동으로 생성할 때
- 최종 비디오(MP4 형식)를 렌더링할 때
사용하지 말아야 할 경우:
- 기사에서 직접 스크립트를 생성할 때(
article-to-script스킬 사용) - 기존 비디오를 편집하거나 클리핑할 때
- 대화형 비디오 콘텐츠를 만들 때
사전 요구 사항
필수
- script.json -
article-to-script스킬의 출력 - Node.js - 버전 18+ 및 pnpm 패키지 매니저
- remotion-best-practices 스킬 - 컴포넌트 품질 보장을 위해 참조 필수
선택 사항
- Google Gemini API Key - TTS 오디오 생성용
- 배경 음악 - BGM 파일 (필요 시)
워크플로우
이 스킬은 4단계 워크플로우를 따릅니다:
1단계: 컴포넌트 생성 (30-45분)
각 장면에 대한 React 컴포넌트 생성
프로세스:
- script.json 읽기
- remotion-best-practices 스킬 참조
- 각 장면 유형에 해당하는 컴포넌트 생성
- spring 애니메이션 사용 확인 (CSS 애니메이션 사용 금지)
- fitText/measureText를 사용한 텍스트 크기 처리
규칙 파일: rules/component-generation.md
장면 유형 가이드: rules/scene-types/*.md (6개 파일)
2단계: 프로젝트 조립 (15-20분)
완전한 Remotion 프로젝트 구조 생성
프로세스:
- 프로젝트 디렉토리 구조 생성
- package.json, tsconfig.json, remotion.config.ts 복사
- Root.tsx 메인 컴포넌트 생성
- 공유 컴포넌트 복사 (NeonBackground, Subtitle 등)
- 테마 파일 복사 (theme.ts)
- 의존성 설치
규칙 파일: rules/project-assembly.md
3단계: TTS 오디오 생성 (선택 사항, 10-15분)
Google Gemini API를 사용하여 TTS 오디오 생성
프로세스:
- 독립형 tts-generator.js 스크립트 생성
- 각 장면에 대한 오디오 파일 생성
- 1.25x 재생 속도 적용
- 자막 분할 데이터 생성
- public/audio/ 디렉토리에 저장
규칙 파일: rules/tts-integration.md, rules/subtitle-generation.md
4단계: 미리보기 및 렌더링 (5-10분)
미리보기 시작 및 비디오 렌더링
프로세스:
- Remotion 미리보기 서버 시작 (
pnpm start) - 브라우저에서 확인
- 최종 비디오 렌더링 (
pnpm build) - video.mp4 출력
규칙 파일: rules/render-configuration.md
빠른 시작
# 1. script.json 준비
# article-to-script를 통해 생성되었다고 가정
# 2. remotion-best-practices 참조
Read .claude/skills/remotion-best-practices/skill.md
# 3. script-to-remotion 규칙 참조
Read .claude/skills/script-to-remotion/rules/component-generation.md
Read .claude/skills/script-to-remotion/rules/scene-types/*.md
# 4. 컴포넌트 생성 (각 장면별)
# 장면 유형에 따라 해당 템플릿과 규칙을 선택하여 코드 생성
# 5. 프로젝트 조립
Read .claude/skills/script-to-remotion/rules/project-assembly.md
# 설명에 따라 완전한 프로젝트 구조 생성
# 6. 선택 사항: TTS 생성
Read .claude/skills/script-to-remotion/rules/tts-integration.md
# tts-generator.js 생성 및 실행
# 7. 의존성 설치
cd video-output-<timestamp>
pnpm install
# 8. 미리보기
pnpm start
# 브라우저에서 http://localhost:3000 접속
# 9. 렌더링
pnpm build
# out/video.mp4로 출력
핵심 기능
6가지 장면 유형 지원
각 장면 유형에는 전용 템플릿과 애니메이션이 있습니다:
| 장면 유형 | 길이 | 용도 | 주요 특징 |
|---|---|---|---|
| hook | 5-8초 | 오프닝 훅 | 타자기 효과, 바운스 애니메이션 |
| textDisplay | 15-20초 | 핵심 정보 표시 | fitText 자동 맞춤, 슬라이드인 애니메이션 |
| numberComparison | 12-18초 | 데이터 비교 | 숫자 애니메이션, 전후 비교 레이아웃 |
| threeColumns | 15-20초 | 3열 비교 | 지연 표시, Series 시퀀스 |
| caseStudy | 20-30초 | 사례 스토리 | TransitionSeries, 전환 효과 |
| cta | 8-12초 | 행동 촉구 | 다단계 표시, 강조 애니메이션 |
Spring 물리 애니메이션
모든 애니메이션은 Remotion의 spring() 물리 엔진을 사용합니다:
const scale = spring({
frame,
fps,
config: { damping: 12, stiffness: 100 }
});
CSS 애니메이션 사용 금지 (remotion-best-practices 위반)
반응형 텍스트
@remotion/layout-utils를 사용하여 텍스트가 적절히 표시되도록 보장합니다:
import { fitText, measureText } from '@remotion/layout-utils';
const fittedText = fitText({
text: narration,
withinWidth: 1600,
fontFamily: 'Inter',
fontSize: 80
});
스마트 자막 분할
긴 나레이션을 읽기 쉬운 자막으로 자동 분할:
- 구두점에 따라 자연스럽게 문장 분할
- 각 세그먼트 3-8초 길이
- 페이드 인/아웃 효과 (0.2초)
- 오디오와 완벽 동기화
규칙 파일
모든 워크플로우 규칙은 rules/ 디렉토리에 문서화되어 있습니다:
핵심 규칙:
component-generation.md- React 컴포넌트 생성 가이드project-assembly.md- 프로젝트 구조 및 구성render-configuration.md- Remotion 렌더링 설정troubleshooting.md- 일반적인 문제 해결
장면 유형 가이드 (6개):
scene-types/hook-scene.md- 오프닝 훅 장면scene-types/text-display-scene.md- 텍스트 표시 장면scene-types/number-comparison-scene.md- 숫자 비교 장면scene-types/three-columns-scene.md- 3열 장면scene-types/case-study-scene.md- 사례 스토리 장면scene-types/cta-scene.md- CTA 장면
오디오 및 자막:
tts-integration.md- TTS 오디오 생성 (선택 사항)subtitle-generation.md- 자막 분할 알고리즘
템플릿 파일
바로 사용 가능한 코드 템플릿이 templates/ 디렉토리에 있습니다:
구성 파일:
package.json.template- 프로젝트 의존성tsconfig.json.template- TypeScript 구성remotion.config.ts.template- Remotion 설정theme.ts- 네온 유리체 테마
공유 컴포넌트:
components/NeonBackground.tsx- 동적 그라데이션 배경components/SceneAudio.tsx- 오디오 플레이어components/Subtitle.tsx- 자막 컴포넌트
기타:
Root.tsx.template- 메인 컴포넌트 템플릿tts-generator.js.template- TTS 생성 스크립트
예제
examples/script-input.json- 예제 입력 스크립트examples/Hook-scene-example.tsx- 전체 Hook 장면 컴포넌트examples/complete-project/- 전체 프로젝트 참조
Bash 명령어
모든 CLI 작업은 commands/bash-commands.md에 문서화되어 있습니다:
- 프로젝트 설정 명령어
- 의존성 설치
- TTS 생성 (선택 사항)
- 미리보기 및 렌더링
- 오류 처리
품질 보증
remotion-best-practices 준수 필수
핵심 규칙:
- ✅ 모든 애니메이션에 spring() 사용
- ✅ fitText/measureText로 텍스트 처리
- ✅ 컴포넌트는 순수 함수여야 함 (부수 효과 없음)
- ✅ useCurrentFrame() 및 useVideoConfig() 올바르게 사용
- ❌ CSS animations 또는 transitions 사용 금지
- ❌ useState/useEffect 사용 금지
- ❌ 외부 API 호출 금지
컴포넌트 품질 기준
생성된 각 컴포넌트는 다음을 충족해야 합니다:
- TypeScript 오류 없이 컴파일
- 올바른 유형 내보내기 (장면 컴포넌트)
- Props에 startFrame, durationFrames, scene 포함
- 부드러운 애니메이션 (60fps)
- 텍스트가 명확하고 읽기 쉬움
- 색상 대비 충분
문제 해결
일반적인 문제 및 해결 방법은 rules/troubleshooting.md에 있습니다:
- TypeScript 컴파일 오류
- 애니메이션 끊김
- 텍스트 오버플로우
- 오디오 동기화 문제
- 렌더링 실패
버전 이력
- v3.0.0 (2025-01): 순수 문서 기반 스킬, 템플릿 중심
- v2.1.0 (2024-12): CLI 기반 Phase 4-8 구현
- v1.0.0 (2024-11): 초기 모놀리식 스킬
지원
문제 발생 시:
rules/troubleshooting.md에서 일반적인 문제 확인examples/의 예제 구현 참조remotion-best-practices스킬 문의- Remotion 공식 문서 확인
관련 스킬
- article-to-script - 상위: script.json 생성
- remotion-best-practices - 참조 필수: 컴포넌트 품질 보장