이 스킬이 활성화되면 항상 첫 응답을 :movie_camera: 이모지로 시작하세요.
비디오 크리에이터
이것은 엔드투엔드 비디오 생성을 위한 오케스트레이터 스킬입니다. 사용자가 "비디오가 필요해"라고 말하는 것부터 완성된 4K 렌더링까지 이어지는 완전한 7단계 워크플로를 조정합니다. 각 단계는 동반 스킬(remotion-video, video-scriptwriting, video-audio-design, video-analyzer)에 위임되며, 이 스킬은 시퀀싱, 승인 게이트 및 단계 간 핸드오프를 관리합니다.
Remotion 내부 구조나 오디오 엔지니어링을 알 필요가 없습니다. 이러한 작업은 동반 스킬이 처리합니다. 이 스킬의 역할은 프로세스를 실행하고, 올바른 질문을 하며, 어떤 단계도 건너뛰지 않도록 하는 것입니다.
이 스킬을 사용해야 하는 경우
사용자가 다음과 같은 경우 이 스킬을 트리거하세요:
- "make me a video", "create a video about", "I need a video for"라고 말하는 경우
- 제품 데모, 설명 영상, 소셜 클립 또는 공지 비디오를 원하는 경우
- 컨셉부터 렌더링까지 엔드투엔드 비디오 제작을 요청하는 경우
- 아이디어를 완성된 비디오 파일로 바꾸는 데 도움이 필요한 경우
- Remotion으로 프로그램 방식 비디오를 만들고 싶다고 언급하는 경우
- 참조 비디오가 있고 유사한 것을 만들고 싶어하는 경우
다음과 같은 경우 이 스킬을 트리거하지 마세요:
- 기존 비디오 파일 편집 (video-analyzer 또는 ffmpeg 스킬 사용)
- 비디오를 제작하지 않고 스크립트만 작성 (video-scriptwriting 사용)
- 팟캐스트와 같은 오디오 전용 제작 (음악/SFX는 video-audio-design 사용)
- 제작 컨텍스트 없이 Remotion 코딩 질문 (remotion-video 사용)
- 비디오 분석 또는 검토 (video-analyzer 사용)
핵심 원칙
-
시각 우선: 오디오에 비용을 지불하기 전에 시각 자료를 먼저 승인받으세요. 나레이션은 ElevenLabs를 통해 실제 비용이 발생합니다. 시각 레이어가 확정될 때까지 절대 생성하지 마십시오.
-
철저한 인터뷰: 제품, 대상, 목표, 톤, 자산 및 시각적 선호도에 대한 모든 컨텍스트를 캡처하기 위해 최대 30개의 질문을 하세요. 불완전한 컨텍스트는 값비싼 재작업으로 이어집니다.
-
구조화된 핸드오프:
video-script.yaml파일은 모든 단계 간의 단일 진실 공급원(Single Source of Truth)입니다. 모든 장면, 프레임 수, 나레이션 라인 및 SFX 큐가 이 파일에 있습니다. -
사용자 승인 게이트: 각 주요 단계에서 명시적인 승인이 필요합니다. 절대 자동 진행하지 마십시오. 다음 단계를 시작하기 전에 사용자가 "승인" 또는 "좋아 보인다"고 말해야 합니다.
-
4K 기본값: 사용자가 달리 지정하지 않는 한 항상 3840x2160으로 렌더링하세요. 다운스케일링은 쉽지만 업스케일링은 그렇지 않습니다.
7단계 워크플로
0단계: Remotion 프로젝트가 있는지 확인 (전제 조건)
무엇보다도 먼저 사용자에게 Remotion 프로젝트가 설정되어 있어야 합니다. 모든 비디오 코드가 작성될 작업 공간입니다. 이미 Remotion 프로젝트 내에 있는지 확인하세요 (remotion.config.ts 또는 package.json 내 @remotion/cli 찾기). 그렇지 않으면 스캐폴딩하세요:
npx create-video@latest
그러면 스타터 프로젝트가 있는 새 폴더가 생성됩니다. 그런 다음 종속성을 설치하세요:
cd <project-name>
npm install
Remotion 프로젝트가 존재하고 종속성이 설치될 때까지 1단계로 진행하지 마십시오. 이후 모든 단계는 이 프로젝트에 코드를 작성합니다.
사용자에게 이미 Remotion 프로젝트가 있다면 cd로 들어가서 계속 진행하세요.
1단계: 심층 인터뷰
완전한 스크립트를 작성하는 데 필요한 모든 컨텍스트를 수집하세요. 대화형 접근 방식을 사용하여 한 번에 하나씩 질문하세요.
질문 카테고리 (총 15-30개 질문 목표):
| 카테고리 | 예시 질문 |
|---|---|
| 제품/주제 | 이 제품은 무엇을 하나요? 핵심 가치 제안은 무엇인가요? |
| 대상 | 대상 시청자는 누구인가요? 기술 수준은 어느 정도인가요? |
| 비디오 목표 | 시청자가 시청 후 무엇을 하길 바라나요? |
| 톤/스타일 | 재미있게? 전문적으로? 빠른 속도? 느린 속도? |
| 자산 | 로고, 스크린샷, 브랜드 색상, 폰트가 있나요? |
| 내용 | 다루어야 할 주요 기능이나 메시지는 무엇인가요? |
| 시각적 선호도 | 참조 비디오가 있나요? 선호하는 애니메이션 스타일은? |
| 길이 | 비디오 길이는 어느 정도여야 하나요? 어디에 게시할 건가요? |
1단계 규칙:
- 한 번에 하나의 질문만 하세요. 질문 목록을 한꺼번에 던지지 마십시오.
- 사용자가 참조 비디오를 제공하는 경우, 질문하기 전에 먼저 video-analyzer 스킬을 사용하여 해당 비디오를 분석하세요.
- 5-8개 질문마다 지금까지 알게 된 내용을 요약하세요.
- 모든 장면에 대한 충분한 컨텍스트를 얻을 때까지 진행하지 마십시오.
- 다음으로 끝내세요: "스크립트를 작성할 충분한 컨텍스트를 얻었습니다. 진행할 준비가 되셨나요?"
종료 기준: 사용자가 충분한 컨텍스트가 있다고 확인합니다.
2단계: 스크립트 생성 (YAML)
video-scriptwriting 스킬의 패턴을 사용하여 구조화된 YAML 스크립트를 생성합니다.
프레임 수 공식:
frames = duration_seconds * 30
모든 Remotion 컴포지션은 기본적으로 30fps를 사용합니다.
다음 구조로 video-script.yaml 파일을 생성하세요:
title: "Product Demo - Acme Widget"
fps: 30
resolution: { width: 3840, height: 2160 }
total_duration_seconds: 60
scenes:
- id: scene-01
title: "Hook"
duration_seconds: 5
frames: 150
narration: "Ever wished your widgets could think for themselves?"
visuals: "Dark background, glowing Acme logo fades in, particles"
animation_notes: "Logo scale 0->1 with spring, particles emit from center"
music_cue: "Ambient synth pad, low energy"
sfx: "Subtle whoosh on logo reveal"
transition_out: "crossfade"
- id: scene-02
# ... 모든 장면에 대해 계속
2단계 규칙:
- 모든 장면에는
duration_seconds,frames,narration,visuals,animation_notes,music_cue및sfx필드가 있어야 합니다. - 프레임 수는
duration_seconds * 30과 같아야 합니다. - 전체 장면 길이의 합은
total_duration_seconds와 같아야 합니다. - 전체 스크립트를 사용자에게 검토용으로 제시하세요.
- 사용자가 명시적으로 승인할 때까지 피드백을 반영하여 수정하세요.
종료 기준: 사용자가 스크립트를 승인합니다.
3단계: 시각적 검증
오디오 레이어 없이 시각 자료만 있는 최소한의 Remotion 프로젝트를 구축하세요.
구축할 내용:
- 각 장면에 대한 Remotion 컴포지션 (시각 자료, 애니메이션, 타이포그래피, 색상)
- 스크립트와 일치하는 장면 전환
- 장면별 올바른 프레임 수
- 4K 해상도의 기본 레이아웃 및 간격
아직 구축하지 말아야 할 것:
- 오디오 통합
- 나레이션 동기화
- 볼륨 덕킹
- 최종 렌더링 파이프라인
프로세스:
- Remotion 프로젝트가 설정되었는지 확인 (0단계에서 완료)
- 프로젝트 내 각 장면에 대한 시각적 컴포지션 구축
- Remotion Studio 실행:
npx remotion studio - 사용자에게
http://localhost:3000에서 미리보기를 하라고 알림 - 시각적 피드백(색상, 타이밍, 애니메이션, 전환)에 대해 반복
- 진행하기 전에 명시적인 시각적 승인 받기
종료 기준: 사용자가 시각 자료를 명시적으로 승인합니다.
4단계: 전체 Remotion 프로젝트 구축
이제 시각 자료가 승인되었으므로 전체 프로젝트를 완성합니다.
작업:
- 모든 컴포지션을 다듬어진 애니메이션으로 마무리
- 장면 간 전환 연결
- 매개변수화(제목, 색상, 길이 등)를 위한 Zod 스키마 추가
- 프레임 수가 스크립트와 정확히 일치하는지 확인
- 프로젝트 구조를 깔끔하게 정리:
src/
compositions/
Scene01Hook.tsx
Scene02Feature.tsx
...
components/
AnimatedLogo.tsx
TransitionWipe.tsx
...
Root.tsx
index.ts
video-script.yaml
4단계 규칙:
- 각 장면은 자체 컴포지션 파일이어야 합니다.
- 공유 컴포넌트는
components/에 넣으세요. - 모든 매직 넘버는 Zod 스키마 프롭으로 대체되어야 합니다.
- 프레임 수는 여전히
video-script.yaml과 일치해야 합니다.
종료 기준: 전체 프로젝트가 오류 없이 빌드되고 승인된 시각 자료와 일치합니다.
5단계: 배경 오디오 + SFX 추가
video-audio-design 스킬의 패턴을 사용합니다.
작업:
- 배경 음악 소싱 또는 선택 (사용자 제공 또는 문서화된 소스에서)
- 스크립트의 트리거 지점에 SFX 배치 (클릭, 타이핑, 휘파람 소리 등)
- 음악 및 SFX의 기본 볼륨 레벨 설정
- 덕킹 인프라 구현 - 6단계에서 나레이션 중에 음악을 낮출 볼륨 커브 준비
- Remotion Studio에서 오디오-비주얼 동기화 미리보기
볼륨 가이드라인:
| 레이어 | 기본 볼륨 | 나레이션 중 |
|---|---|---|
| 배경 음악 | 0.3-0.5 | 0.1-0.15 |
| SFX | 0.5-0.8 | 0.4-0.6 |
| 나레이션 | 해당 없음 (6단계) | 1.0 |
종료 기준: 사용자가 오디오-비주얼 동기화를 승인합니다.
6단계: 나레이션 추가 (지연됨 - 비용 발생)
이 단계에는 ElevenLabs에 대한 유료 API 호출이 포함됩니다. 진행하기 전에 항상 확인하세요.
설정:
- 사용자에게 ElevenLabs API 키가 있는지 확인
- 없는 경우
https://elevenlabs.io에서 가입을 안내 - 음성 선호도 질문:
- 성별 선호도?
- 연령대 (젊은, 중년, 성숙)?
- 억양 선호도?
- 에너지 레벨 (차분함, 보통, 활기참)?
- 따뜻함 (따뜻하고 친근함, 중립적, 권위적)?
프로세스:
- ElevenLabs API를 통해 각 장면에 대한 나레이션 오디오 생성
- 생성된 파일에서 정확한 오디오 길이 계산
- 나레이션이 계획보다 길거나 짧은 경우 프레임 수 조정
- 실제 오디오 길이로
video-script.yaml업데이트 - 시각적 타이밍과 나레이션 동기화
- 나레이션 구간 동안 배경 음악에 대한 볼륨 덕킹 활성화
- Remotion Studio에서 전체 오디오 믹스 미리보기
6단계 규칙:
- API 호출 전에 항상 비용을 확인하세요.
- 사용자가 나레이션을 건너뛰고 싶다면 괜찮습니다. 나레이션 없이 7단계로 진행하세요.
- 사용자가 다른 TTS 제공자를 선호하는 경우 지원하세요.
- 오디오 길이가 스크립트 예상과 다른 경우 모든 타이밍을 다시 동기화하세요.
종료 기준: 사용자가 나레이션 동기화를 승인하거나 (또는 명시적으로 이 단계를 건너<ds_safety>用户问题要求将AI技能文档从英文翻译为韩文,内容涉及视频制作工作流程的7个步骤,包括Remotion项目搭建、脚本生成、视觉验证、音频设计、配音和4K渲染等技术细节。模型回答严格遵循了翻译要求,输出的是完整的韩文翻译内容,未涉及任何色情、政治敏感或其他违规内容。整个回答聚焦于技术文档的本地化处理,符合安全规范。</ds_safety>Safe</ds_safety>跳到 7단계)
7단계: 최종 미리보기 + 4K 렌더링
프로세스:
- Remotion Studio에서 모든 레이어로 전체 미리보기 실행
- 사용자에게 완전한 비디오(시각 자료 + 음악 + SFX + 나레이션) 검토 요청
- 최종 승인 받기
- 4K로 렌더링:
npx remotion render src/index.ts Main out/video.mp4 \
--width 3840 --height 2160
포맷 가이드:
| 포맷 | 사용 사례 |
|---|---|
| MP4 (H.264) | 웹, 소셜 미디어, 일반 공유 |
| MP4 (H.265) | 더 작은 파일 크기, 최신 기기 재생 |
| ProRes | Premiere, Final Cut, DaVinci에서 추가 편집 |
| WebM (VP9) | 투명도 지원이 있는 웹 임베딩 |
종료 기준: 렌더링된 비디오 파일이 사용자에게 전달됩니다.
오케스트레이션 규칙
- 각 단계는 다음 단계로 진행하기 전에 명시적인 사용자 승인이 필요합니다.
- 각 단계에서 수행 중인 작업과 그 이유를 설명하세요.
- 사용자가 참조 비디오를 제공하는 경우, 1단계를 시작하기 전에 먼저 video-analyzer를 실행하세요.
- 항상 단일 진실 공급원으로
video-script.yaml을 생성하세요. - Remotion 프로젝트 구조는 깔끔하고 잘 정리되어야 합니다.
- 사용자가 나레이션(6단계)을 건너뛰고 싶다면 바로 7단계로 진행하세요.
- 사용자가 다른 TTS 제공자를 원하는 경우 그에 따라 6단계를 조정하세요.
- 시각적 승인(3단계 완료) 전에는 절대 나레이션 오디오를 생성하지 마십시오.
- 시각적 검증을 절대 건너뛰지 마십시오. 값비싼 재작업을 방지합니다.
- 사용자가 달리 지정하지 않는 한 항상 4K(3840x2160)를 기본값으로 사용하세요.
지원되는 비디오 유형
| 유형 | 길이 | 장면 수 | 장면당 길이 |
|---|---|---|---|
| 제품 데모 | 30-120초 | 6-15 | 5-10초 |
| 설명 영상 | 60-180초 | 8-20 | 5-12초 |
| 소셜 클립 | 15-60초 | 3-8 | 3-8초 |
| 공지 영상 | 15-45초 | 3-6 | 4-8초 |
안티 패턴 / 일반적인 실수
| 안티 패턴 | 실패 이유 | 올바른 접근 방식 |
|---|---|---|
| 시각적 승인 전에 나레이션 생성 | 시각 자료가 변경되면 비용 낭비 | 먼저 1-4단계 완료 후 나레이션 |
| 인터뷰 건너뛰기 | 스크립트에 컨텍스트 부족, 장면이 일반적임 | 15-30개의 타겟 질문 |
| YAML 스크립트 파일 없음 | 진실 공급원 없음, 타이밍 표류 | 항상 video-script.yaml 생성 |
| 승인 없이 자동 진행 | 사용자 통제력 상실, 재작업 비용 발생 | 각 게이트에서 명시적 "승인" 대기 |
| Remotion에 값 하드코딩 | 매개변수화 또는 재사용 불가 | 모든 구성 가능한 값에 Zod 스키마 사용 |
| 기본적으로 1080p로 렌더링 | 나중에 업스케일링 불가 | 항상 4K(3840x2160) 기본값 사용 |
| 오디오와 시각 자료 동시 구축 | 반복 작업이 어려움 | 시각 우선, 승인 후 오디오 |
주의사항
-
프레임 수 계산이 중요합니다. 30fps에서 60초는 정확히 1800프레임입니다. 장면 길이가 올바르게 합산되지 않으면 비디오가 너무 짧거나 길어집니다. 항상 확인:
sum(scene.duration_seconds) == total_duration_seconds. -
Remotion Studio는 실행 중인 개발 서버가 필요합니다. 컴포지션을 구축한 후에는
npx remotion studio를 실행하고 사용자에게http://localhost:3000을 열라고 알려야 합니다. 사용자가 이것 없이 미리보기를 할 수 있다고 가정하지 마십시오. -
ElevenLabs 나레이션 길이는 예측 불가능합니다. 5초짜리 스크립트 라인이 4.2초 또는 6.1초의 오디오를 생성할 수 있습니다. 생성 후 항상 실제 길이를 측정하고 그에 따라 프레임 수를 조정하세요.
-
볼륨 덕킹은 나레이션 타이밍을 알아야 합니다. 배경 음악의 덕킹 커브는 각 장면에서 나레이션이 정확히 언제 시작되고 끝나는지 아는 데 달려 있습니다. 이것이 5단계가 덕킹 인프라를 설정하고 6단계가 이를 활성화하는 이유입니다.
-
4K 렌더링은 느립니다. 3840x2160에서 60초 비디오는 복잡성에 따라 10-30분이 소요될 수 있습니다. 시작하기 전에 사용자에게 렌더링 시간에 대해 경고하고, 빠른 확인을 원할 경우 1080p 테스트 렌더를 먼저 제안하세요.
참고 자료
references/workflow-checklist.md- 각 7단계에 대한 세부 체크리스트 (하위 작업, 예상 출력, 승인 기준 포함)references/project-templates.md- 각 비디오 유형에 대한 스타터 Remotion 프로젝트 구조 (파일 트리 및 컴포넌트 스캐폴드 포함)references/troubleshooting.md- 일반적인 문제 및 해결 방법 (Remotion 렌더링, 오디오 동기화, FFmpeg, ElevenLabs API, 성능 관련)
동반 스킬 확인
대화에서 이 스킬이 처음 활성화될 때:
ls ~/.claude/skills/ ~/.agent/skills/ ~/.agents/skills/ .claude/skills/ .agent/skills/ .agents/skills/ 2>/dev/null명령을 실행하여 어떤 동반 스킬이 설치되어 있는지 확인하세요. 결과를 이 파일의 프론트매터에 있는recommended_skills필드와 비교하세요. 누락된 스킬이 있으면 한 번 언급하고 설치를 제안하세요:...
[번역을 위해 잘림]