Communitygithub.com

WhiteRabbitLAB/baitu-video

코드로 설명 영상을 만드는 완전한 방법. 주제 무관(과학·AI 사용법·역사·리뷰 등): 주제 선정 → 사실표 → 대본 및 대사 점검 → 더빙·자막 → '영상 유형 × 장면 × 화풍'에 따른 화면(글꼴·대화 상자는 장면에 따라 변경, 선택적 캐릭터 연기) → 렌더링·믹싱 → 세로형 썸네일 → 검수. 영상 유형 라이브러리, 장면 라이브러리, 화풍 라이브러리, 디자인 라이브러리(글꼴/색상 팔레트/컴포넌트/모션 효과) 및 채널 설정을 포함하며, 모두 추가 가능. 사용자가 '새 영상 만들어 줘', '장면/화풍 바꿔 줘', '영상 유형/장면/화풍 추가해 줘', '캐릭터 애니메이션 부분 만들어 줘'라고 할 때 사용합니다.

baitu-video란 무엇인가요?

이 스킬은 개발자가 코드를 활용하여 설명 영상을 제작하는 전체 파이프라인을 제공합니다. 주제(과학, AI 사용법, 역사, 제품 리뷰 등)에 구애받지 않으며, 영상 유형, 장면, 화풍을 주제와 독립적으로 분리하여 관리하므로 새로운 주제나 스타일을 쉽게 조합할 수 있습니다. 내부는 영상 유형(format), 장면(scene), 화풍(style), 채널 설정(profile)의 네 가지 계층으로 구성되며, 각 계층은 독립적이어서 원하는 부분만 교체할 수 있습니다. 또한 디자인 라이브러리(글꼴, 색상 팔레트, 컴포넌트, 모션 효과)와 캐릭터 연기 모듈을 포함하여 시각적 일관성과 표현력을 높입니다. 사용자는 '네 가지 질문'(목적, 업종, 느낌, 플랫폼)에 답하기만 하면 카탈로그에서 적절한 조합을 추천받고, 파이프라인 문서에 따라 대본, 화면, 더빙, 자막, 렌더링, 검수까지 진행할 수 있습니다. 엔진은 CLI 도구를 제공하며, 예제와 함께 바로 실행 가능한 데모도 포함되어 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add WhiteRabbitLAB/baitu-video

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

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

문서

설명 영상 제작

English: SKILL.en.md

주제 무관. 현재 저자의 두 채널(영양 과학 10편, AI 사용법 6편 + 17분 통사 장편)에서 축적되었으며, 영상 유형, 장면, 화풍은 주제와 무관한 형태로 작성되어 두 채널의 사례를 서로 차용할 수 있습니다.

사용 전에 알아두세요: 스킬은 바닥이지 천장이 아닙니다

규칙은 세 가지 무게로 나뉩니다:하드 규칙(사실, 안전, 플랫폼, 의사 결정자가 결정한 것, 반드시 지켜야 함), 능력 한계(당시 모델이 할 수 없어서 정한 것, 날짜가 표시되어 있으며 모델이 강화되면 다시 테스트하여 완화), 기본값(매개변수, 템플릿, 뼈대 – 시작점이지 상한이 아니며, 더 잘할 수 있으면 하고 기록을 남겨 비교). 자세한 내용은 principles.md 서두를 참조하세요. 문서에 어떤 매개변수가 적혀 있다고 해서 더 나은 방법을 포기하지 말고, 문서에 없다고 해서 하지 말라는 법도 없습니다.

사용자 진입점: 네 가지 질문

  1. 무엇을 하고 싶나요?(과학 설명 / 스토리 다큐 / 교육 튜토리얼 / 리뷰 비교 / 의견 표현 / 목록 정리 / 정보 요약)
  2. 어떤 업종인가요?(건강 영양 / 기술 AI / 인문 역사 예술 / 자연 과학 / 사회 심리 법률 / 재경 비즈니스 / 교육 학습 / 직장 스킬 / 생활)
  3. 어떤 느낌을 원하나요?(화풍 썸네일을 보고 선택)
  4. 어느 플랫폼에 게시하나요?(가로형 플랫폼: 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의 화면 페이지는 삭제되었으며, 해당 글꼴 표 전체는 추정치입니다.

관련 스킬