Communitygithub.com

joyehuang/skills

구조화된 비디오 스크립트를 React 컴포넌트, 오디오, 렌더링이 포함된 프로덕션 준비 완료 Remotion 프로젝트로 변환합니다.

skills란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code, Cursor)가 구조화된 비디오 스크립트(script.json)를 완전한 Remotion 비디오 프로젝트로 변환할 수 있도록 설계되었습니다. 4단계 워크플로우를 통해 React 컴포넌트 생성, 프로젝트 조립, TTS(Text-to-Speech) 오디오 통합, 최종 MP4 렌더링을 자동화합니다. 핵심 기능으로는 6가지 장면 유형(hook, textDisplay, numberComparison, threeColumns, caseStudy, cta)을 위한 특화 템플릿과 Remotion의 spring() 물리 엔진을 사용한 애니메이션, `@remotion/layout-utils`를 활용한 반응형 텍스트 처리를 지원합니다. 또한 Google Gemini API를 통한 선택적 TTS 오디오 생성과 스마트 자막 분할 기능을 제공합니다. 이 스킬은 `remotion-best-practices` 스킬을 참조해야 하며, CSS 애니메이션 및 부수 효과(state/effect) 사용을 금지하는 등 엄격한 품질 기준을 따릅니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/joyehuang/skills/tree/HEAD/script-to-remotion

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

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

문서

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 컴포넌트 생성

프로세스:

  1. script.json 읽기
  2. remotion-best-practices 스킬 참조
  3. 각 장면 유형에 해당하는 컴포넌트 생성
  4. spring 애니메이션 사용 확인 (CSS 애니메이션 사용 금지)
  5. fitText/measureText를 사용한 텍스트 크기 처리

규칙 파일: rules/component-generation.md 장면 유형 가이드: rules/scene-types/*.md (6개 파일)

2단계: 프로젝트 조립 (15-20분)

완전한 Remotion 프로젝트 구조 생성

프로세스:

  1. 프로젝트 디렉토리 구조 생성
  2. package.json, tsconfig.json, remotion.config.ts 복사
  3. Root.tsx 메인 컴포넌트 생성
  4. 공유 컴포넌트 복사 (NeonBackground, Subtitle 등)
  5. 테마 파일 복사 (theme.ts)
  6. 의존성 설치

규칙 파일: rules/project-assembly.md

3단계: TTS 오디오 생성 (선택 사항, 10-15분)

Google Gemini API를 사용하여 TTS 오디오 생성

프로세스:

  1. 독립형 tts-generator.js 스크립트 생성
  2. 각 장면에 대한 오디오 파일 생성
  3. 1.25x 재생 속도 적용
  4. 자막 분할 데이터 생성
  5. public/audio/ 디렉토리에 저장

규칙 파일: rules/tts-integration.md, rules/subtitle-generation.md

4단계: 미리보기 및 렌더링 (5-10분)

미리보기 시작 및 비디오 렌더링

프로세스:

  1. Remotion 미리보기 서버 시작 (pnpm start)
  2. 브라우저에서 확인
  3. 최종 비디오 렌더링 (pnpm build)
  4. 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가지 장면 유형 지원

각 장면 유형에는 전용 템플릿과 애니메이션이 있습니다:

장면 유형길이용도주요 특징
hook5-8초오프닝 훅타자기 효과, 바운스 애니메이션
textDisplay15-20초핵심 정보 표시fitText 자동 맞춤, 슬라이드인 애니메이션
numberComparison12-18초데이터 비교숫자 애니메이션, 전후 비교 레이아웃
threeColumns15-20초3열 비교지연 표시, Series 시퀀스
caseStudy20-30초사례 스토리TransitionSeries, 전환 효과
cta8-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 - 참조 필수: 컴포넌트 품질 보장

관련 스킬