설명 영상 제작
English: SKILL.en.md
주제 무관. 현재 저자의 두 채널(영양 과학 10편, AI 사용법 6편 + 17분 통사 장편)에서 축적되었으며, 영상 유형, 장면, 화풍은 주제와 무관한 형태로 작성되어 두 채널의 사례를 서로 차용할 수 있습니다.
사용 전에 알아두세요: 스킬은 바닥이지 천장이 아닙니다
규칙은 세 가지 무게로 나뉩니다:하드 규칙(사실, 안전, 플랫폼, 의사 결정자가 결정한 것, 반드시 지켜야 함), 능력 한계(당시 모델이 할 수 없어서 정한 것, 날짜가 표시되어 있으며 모델이 강화되면 다시 테스트하여 완화), 기본값(매개변수, 템플릿, 뼈대 – 시작점이지 상한이 아니며, 더 잘할 수 있으면 하고 기록을 남겨 비교). 자세한 내용은 principles.md 서두를 참조하세요. 문서에 어떤 매개변수가 적혀 있다고 해서 더 나은 방법을 포기하지 말고, 문서에 없다고 해서 하지 말라는 법도 없습니다.
사용자 진입점: 네 가지 질문
- 무엇을 하고 싶나요?(과학 설명 / 스토리 다큐 / 교육 튜토리얼 / 리뷰 비교 / 의견 표현 / 목록 정리 / 정보 요약)
- 어떤 업종인가요?(건강 영양 / 기술 AI / 인문 역사 예술 / 자연 과학 / 사회 심리 법률 / 재경 비즈니스 / 교육 학습 / 직장 스킬 / 생활)
- 어떤 느낌을 원하나요?(화풍 썸네일을 보고 선택)
- 어느 플랫폼에 게시하나요?(가로형 플랫폼: YouTube, Bilibili, 공식 계정 동영상 등; 세로형 플랫폼: TikTok, WeChat Video 세로, Xiaohongshu 등) → 해당 화면 비율만 출력: 가로형 플랫폼만 선택하면 가로형만, 세로형 플랫폼만 선택하면 세로형만, 둘 다 선택하면 둘 다 제작(의사 결정자 2026-10-07). 세로형은 세로 화면에 맞게 재배치하며, 가로형에서 자르지 않습니다.
→ catalog/에서 권장 조합을 확인하세요. 각 조합에는 상태가 표시됩니다: ✅ 가능(완성본 있음), 🧪 테스트 필요(할 수는 있지만 샘플 없음), ⛔ 현재 불가(실제 출연, 실사 촬영 또는 라이선스 자산 필요). 인기 참고 작품을 템플릿으로 변환할 수 있는지: catalog/references.md. 화풍은 지속적으로 추가됩니다: styles/ROADMAP.md.
내부 구조: 네 계층 + 디자인 라이브러리
사용자는 '목적 × 업종 × 느낌'에 따라 선택합니다; 라이브러리 내부는 아래 네 계층으로 저장되며, 서로 독립적이므로 모든 계층을 개별적으로 교체(사용자 정의)할 수 있습니다.
| 계층 | 담당 | 예 | 라이브러리 |
|---|---|---|---|
| 영상 유형 (Format) | 무엇을 어떻게 이야기할지(내러티브 뼈대) | 실제 실험 다큐, 스토리로 방법 소개 + 실측, 장면 공략 | formats/ |
| 장면 (Scene) | 화면이 어떤 세계인지; 그 안에 어떤 글자 소스, 컴포넌트, 관통 요소가 있는지 | 아카이브 책상, 전략 게임, 기술 터미널, 그림 전시 라벨 | scenes/ |
| 화풍 (Style) | 어떻게 그릴지: 선, 면, 빛, 재질, 모션 감촉, 캐릭터 표현 방식 | 종이 평면, 평면 기하, 기술 다크 인터페이스 | styles/ |
| 채널 설정 (Profile) | 특정 채널에만 속하는 설정: 마스코트, 자막 규격, 더빙, 플랫폼 규칙, 의사 결정자 선호도, 도구 체인 명령 | 작성된 예시 | profiles/ |
장면과 화풍은 하나의 디자인 라이브러리(design/)를 공유합니다: 글꼴 디렉토리(글자 소스별), 색상 팔레트, 컴포넌트, 모션 효과 및 재질, 카메라 움직임 및 전환 라이브러리(각 매개변수 출처 표시: 실제 측정 / 직접 / 우리 / 미확인). 화면 속 글자는 '글자 역할'(text-roles.md)에 따라 분류됩니다:장면이나 화풍을 바꿀 때 글꼴, 담체(대화 상자, 쪽지, 패널), 등장 방식 전체가 함께 변경됩니다; 자막과 챕터 진행률 표시줄은 채널 설정에 속하므로 변경되지 않습니다. 캐릭터 연기가 필요한 경우 캐릭터 모듈(characters/)을 추가합니다: 이미지 생성은 미술, 코드는 엔진 역할.
엔진
바로 실행 가능한 예제(중영 더빙, 가로세로 화면 모두 포함): examples/sky-demo.
영상 제작에 사용되는 명령, 공유 화면 컴포넌트 및 검사 도구는 모두 engine/에 있습니다. 처음 사용 시 프로젝트 루트에서 자가 진단을 실행하세요: node .claude/skills/explainer-video/engine/cli.mjs doctor.
먼저 읽을 것
| 할 일 | 읽을 문서 |
|---|---|
| 프로젝트에서 처음 사용할 때 | engine/README.md의 '시작' 다섯 단계를 따르세요: explainer.json → profiles/_template/ 전체를 프로젝트의 profiles/<채널명>/로 복사(스킬 디렉토리에 넣지 마세요. 업그레이드 시 덮어쓰기됨), channel / voice / preferences 세 파일 작성; 작성법은 profiles/example/ 참조(토끼와 선호도는 저자 전용, 사용 권한 없음) |
| 처음부터 영상 제작 | pipeline.md + principles.md + 채널 설정 |
| 영상 유형 / 장면 / 화풍 선택 | 먼저 catalog/의 네 가지 질문을 확인한 후 세 라이브러리의 INDEX 참조 |
| 화면 속 글자 결정 | text-roles.md → 장면 파일의 글자 소스 표 → design/fonts.md |
| 컷 간, 포즈 간 연결 | transitions.md + 카메라 움직임 및 전환 라이브러리 design/camera-transitions.md(매개변수에 참조 출처 있음) |
| 캐릭터 연기 | characters/act-pipeline.md |
| 납품 전 | acceptance.md |
확장 가능: 모든 라이브러리 확장 가능
| 추가할 항목 | 방법 |
|---|---|
| 영상 유형 | formats/_template.md 복사; 내러티브 뼈대, 필수 컷, 연결 선호도 작성; 샘플 검증 후 등록 |
| 장면 | scenes/_template.md 복사;글자 소스 → R1–R10까지 모두 작성, 관통 요소, 컴포넌트; 샘플 검증 후 등록 |
| 화풍 | styles/_template.md 복사;이 화풍에서 캐릭터를 어떻게 그릴지 반드시 작성; 기존 장면 + 캐릭터로 샘플 출력 후 등록 |
| 글꼴 / 색상 팔레트 / 컴포넌트 / 모션 효과 | design/의 해당 파일에 한 줄 추가(글꼴은 상업적 사용 가능해야 함) |
| 캐릭터 | characters/act-pipeline.md에 따라 최종 확정 후 등록 |
| 채널 | profiles/_template/ 폴더 복사(세 파일: 채널 / 더빙 / 선호도) |
매 영상이 완성될 때마다 새로 발견된 문제를 해당 파일에 기록하세요.
상태 및 미확인
할 일 목록(권장 순서대로 번호 매김): TODO.md(저자의 내부 기록, 오픈 소스 버전에는 없음; 공개 화풍 로드맵은 styles/ROADMAP.md 참조).
- 장면과 화풍은 라이브러리에서 분리되어 있습니다; 이전 페이지는 '한 편당 하나의 큰 HTML'로, 둘이 함께 작성되어 있습니다. 자주 사용되는 컴포넌트는 화풍 변경이 가능한 공유 코드
engine/vc/로 추출되었습니다(컴포넌트는 글자 역할만 인식하며, 외형은styles.js가 제공, 10가지 화풍 각각 한 세트, 썸네일은 styles/INDEX.md 참조); 이미 한 편(N10) 전체가 이를 사용하여 제작되었습니다. - 미확인: 동일한 장면에서 화풍 변경 실사; 여러 화풍 혼합 편집; 두 명 이상의 캐릭터 동시 등장; 캐릭터 입모양과 더빙 싱크; 캐릭터 연기를 본편에 삽입.
- AI 사용법 채널의 대본, 인계 문서, 글꼴 표를 기반으로 정리된 영상 유형(story-method-test, howto-guide, product-review, timeline-epic)과 장면(terminal-tech, field-notebook, gallery-wall)은 아직 새 영상에서 사용되지 않았습니다; gallery-wall의 화면 페이지는 삭제되었으며, 해당 글꼴 표 전체는 추정치입니다.