Science Explainer Video Pipeline

Included files

SKILL.md
references/assembly-rules.md
references/image-video-rules.md
references/script-rules.md
references/tts-rules.md
references/upload-rules.md
README.txt

Preview of SKILL.md

---
name: science-explainer-video-pipeline
description: 과학·설명형 숏폼(9:16, 70~75초)과 롱폼(16:9, 15~20분)을 대본 → TTS → 이미지 → AI 영상 → Remotion 조립 → 업로드까지 단계별 승인 게이트로 만드는 제작 순서와 규칙 모음
---

# Science Explainer Video Pipeline

AI 이미지·영상 클립 + TTS 나레이션 + Remotion 조립으로 "과학 설명 영상"을 반복 생산하는 절차서다.
숏폼(세로 9:16, 약 70~75초, 9블록)과 롱폼(가로 16:9, 15~20분, 100블록 안팎) 모두 같은 뼈대를 쓴다.
세부 규칙은 `references/` 안의 파일을 단계에 맞게 읽는다.

## 먼저 알아둘 원칙
1. **한 단계씩, 산출물을 눈으로 확인하고 다음 단계로.** 여러 단계를 한 번에 만들지 않는다.
2. **돈·크레딧이 드는 호출(TTS, 영상 생성)은 사용자 승인 후 1회.** 중간 결과는 파일로 저장해 두고 재호출하지 않는다.
3. **대본이 먼저, 길이는 글자 수로 예측.** 나레이션 속도(초당 글자 수)를 실측해서 블록별 글자 수를 먼저 맞추면 영상 길이 보정이 거의 필요 없다.
4. **사실은 출처로 확인.** 수치·연도·인물·논문은 신뢰할 수 있는 출처(기관 자료, 논문, 공공 자료)로 교차 확인하고, 직접 인용이 확인되지 않으면 인용문 대신 "인물 이름 + 논문 제목 카드"로 대체한다.
5. **같은 소재를 다른 영상과 겹치지 않게.** 새 기획 전에 기존 제작 목록에서 소재·제목 중복을 검색한다.

## 제작 순서 (게이트 포함)
| 단계 | 내용 | 승인 게이트 |
|---|---|---|
| 0. 소재·중복 확인 | 후보 선정, 기존 영상과 소재 겹침 검색, 사실 시트 작성 | 소재 확정 |
| 1. 대본 | 블록 단위(숏폼 9블록 / 롱폼 100+블록) 작성, 훅·반전·엔딩 설계 | **대본 확인** |
| 2. TTS | 대본 전체를 청크(1,900자 이하)로 나눠 1회 호출, 숨소리·무음 정리 | **TTS 호출 승인** |
| 3. 샷플랜 | 블록 ↔ 컷 매핑, 재사용 클립 / 신규 생성 목록 분리 | 샷플랜 확인 |
| 4. 이미지 | 블록별 전용 이미지 생성(프롬프트 6요소 규칙) | 이미지 확인 |
| 5. AI 영상 | 이미지 → 5초 클립(원테이크, 디졸브 없음) | 비용 승인 |
| 6. 조립 | Remotion에서 자막·제목바·그래픽·BGM·효과음 합성, 렌더 | 시사 |
| 7. 출력·업로드 | 영상 + 메타데이터(제목·설명·고정댓글·태그) 정리, 예약 | **업로드 확인** |

## 단계별 핵심 규칙 (요약)
- **대본**: 첫 3초에 숫자·충격 또는 질문으로 시작, 어려운 용어는 쉬운 말로, 마지막은 "팩트 리빌"로 끝낸다. 롱폼은 60~90초마다 새 미스터리·반전을 넣고, 구독자를 부르는 애칭을 정해 챕터 전환에서 쓴다(전체 12~15회 이내). → `references/script-rules.md`
- **TTS**: 숫자는 자막엔 숫자, 읽기용 텍스트엔 한글로(`ttsSubs` 치환 표). 영어 약어·논문 제목도 한글 발음으로. 호출 전 글자 수 ÷ 속도로 길이를 추정하고 허용 범위(숏폼 7.5~8.5초/블록 등)를 벗어나면 대본을 먼저 고친다. → `references/tts-rules.md`
- **이미지**: 프롬프트에 촬영기법·수량·동작·빛·구도·네거티브 6요소를 반드시 넣고, 프롬프트 원문을 파일에 저장한다. 이미지 안에 글자를 넣지 않는다(자막으로 처리). → `references/image-video-rules.md`
- **AI 영상**: 컷 사이를 디졸브 없이 원테이크로 이어지게 프롬프트를 쓰고, 크기·거리·스케일 비교는 AI 영상 대신 Remotion 그래픽으로 직접 만든다.
- **조립**: 자막은 흰 글자 + 검은 스트로크, 제목바는 질문형·숫자 충격형, 렌더는 타임아웃을 늘려서(`--timeout=120000`) 돌리고 **렌더 후 파일 수정시각을 확인**한다. → `references/assembly-rules.md`
- **업로드**: 하루 업로드 개수 한도를 지키고, 제목·썸네일은 같은 소재의 이전 영상과 다르게 한다. 메타데이터는 제목 후보 / 설명 / 고정댓글 / 태그 4섹션 고정 포맷. → `references/upload-rules.md`

## 롱폼 확장 시 추가 항목
- 기존 숏폼 클립을 재사용하고, 부족분만 새로 생성한다(샷플랜에서 "재사용 / 신규" 표시).