Communitygithub.com

설명 영상 제작 도구

블로그 포스트, 논문, PR, 리포지토리, 브랜치, diff 등 다양한 입력을 내레이션과 자막이 포함된 설명 영상으로 만들어줍니다. 기존 영상을 수정하는 것도 가능합니다.

설명 영상 제작 도구란 무엇인가요?

이 스킬은 사용자가 제공한 모든 자료(블로그 포스트 URL, 논문, PR, 리포지토리, 브랜치, diff, 거친 노트 등)를 시청자가 원할 만한 고품질 설명 영상으로 변환합니다. 영상은 '이 스튜디오'(리포지토리의 `videos/` 폴더)에 저장되며, 스킬은 판단과 스토리텔링에 집중하고 구체적인 작업 방식은 `CLAUDE.md`를 참조합니다. 단순히 요약만 하지 않고, 원본 자료를 완전히 이해한 후 명확한 스토리 아크를 구성하고, 실제 UI 스크린샷, 코드 스니펫, 사용자 정의 애니메이션 다이어그램 등 시각적 요소를 적극 활용해 각 장면이 움직이며 설명하도록 만듭니다. 내레이션은 기본적으로 Kokoro 음성을 사용하지만, 더 자연스러운 음성을 원하거나 `OPENROUTER_API_KEY`가 설정된 경우 Gemini TTS를 사용할 수 있습니다. 1~2분짜리 작은 PR 영상부터 5~8분짜리 밀도 높은 포스트 영상까지 내용에 맞게 길이가 조절되며, 완료 전에 스틸 컷과 프리뷰를 확인하고 문제를 수정하는 검증 과정을 거칩니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/triptu/create-explainer-videos/tree/HEAD/.claude/skills/video

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

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

문서

영상 제작

사용자가 건네준 모든 것을 사람들이 원본을 읽는 대신 시청할 만한 영상으로 바꾸세요: 명확한 스토리, 실제 시각 자료, 모든 장면이 움직이며, 정확한 주장.

모든 영상은 이 스튜디오(이 리포지토리의 videos/ 폴더)에 저장됩니다. 먼저 CLAUDE.md를 읽으세요: 명령어, 워크플로, 장면 규칙 및 주의 사항이 있습니다. 이 스킬은 판단에 관한 것이고, CLAUDE.md는 기술적인 절차에 관한 것입니다. 새 프로젝트를 직접 생성하지 마세요. npm run new를 사용하거나 videos/에 있는 기존 영상을 그 자리에서 수정하세요.

작업 방식

처음부터 끝까지 실행하세요. 합리적인 가정을 하고 영상을 만든 다음, 무엇을 가정했는지 보고하세요. 사용자가 명시적으로 확인을 요청하거나, 진정으로 막힌 경우(소스에 접근할 수 없거나, 어떤 PR을 의미하는지 또는 범위가 무엇인지 명확하지 않은 경우)에만 질문을 멈추세요.

자원을 적극 활용하세요. 주어진 자료로만 최소한으로 작동하는 영상이 아닌, 최상의 영상을 목표로 하세요. 도움이 되는 모든 도구를 사용하세요: 웹 검색, 소스의 참고 자료 및 링크된 페이지, 관련 게시물이나 문서, 작성자의 이전 작업, gh, 코드 클론 및 실행, 실제 제품, 그리고 다른 스킬들. 누락된 맥락을 채우고, 주장을 확인하고, 더 나은 시각 자료를 찾고, 용어나 시스템을 추측하지 말고 파악하세요. 좁은 소스가 그 안에 있는 내용으로만 제한되지는 않습니다. 한 접근 방식이 실패하면, 다른 방식을 시도해보고 타협하지 마세요.

시청자 기본 설정:

  • 기사, 게시물 및 논문: 원본을 읽지 않은 똑똑한 시청자.
  • PR, 브랜치, 리포지토리 및 코드: 내부. 시청자는 사용자이며, 종종 검토를 앞두고 있기 때문에 무엇이 수행되었는지 이해하려고 합니다. "이제 자신 있게 검토하거나 논의할 수 있겠다"는 느낌을 최적화하세요. 사용자가 명시적으로 요청한 경우에만 공개 또는 출시 스타일의 영상으로 만드세요.

길이는 내용에 따릅니다. 하나의 작은 PR은 1-2분일 수 있고; 밀도 높은 게시물은 5-8분일 수 있습니다. 억지로 늘리거나 채우지 말고, 한 장면에 한 가지 아이디어만 담으세요.

1. 훑어보기보다 더 잘 이해하세요

한 글자도 쓰기 전에 주요 자료로 가서 전부 읽으세요.

  • 링크 및 논문: 페이지 자체를 가져오세요. 먼저 Raw HTML, 클라이언트 사이드 렌더링이거나 시각 자료를 보거나 녹화해야 하거나, 차단된 경우 Playwright를 사용하세요(CLAUDE.md 참조). 요약본만으로 작업하지 마세요. 전체 텍스트와 모든 그림, 비디오 및 인터랙티브 요소를 가져오세요. 로그인이 필요한 경우 그렇게 알리세요.
  • PR 및 diff: 설명, 전체 diff, 커밋, 리뷰 스레드, 연결된 이슈, CI 결과. 변경된 라인뿐만 아니라 주변 코드(호출자, 데이터 흐름, 테스트)도 읽으세요. 왜 수정했는지, 대안은 무엇이었는지, 위험 요소는 무엇인지 파악하세요. 동작을 보는 것이 도움이 된다면 실행하고 변경 전/후를 캡처하세요.
  • 리포지토리: 진입점, 아키텍처, 주요 데이터 또는 제어 흐름, 그리고 특이한 점.
  • 노트 또는 주제: 정확성을 위해 충분히 조사하고, 주장이 어디서 왔는지 인용하세요.

2. 스토리를 찾으세요

먼저 한 문장으로 요약할 수 있는 핵심 메시지를 결정하고, 그 메시지를 뒷받침하는 스토리 아크를 만드세요. 일반적으로 문제, 핵심 통찰, 작동 방식, 증거, 그리고 의미로 구성됩니다. 리뷰 중심의 PR 영상의 경우 다음 내용도 포함하세요: 변경의 형태, 중요한 결정, 위험하거나 미묘한 부분, 테스트 방법, 리뷰어가 주목해야 할 부분.

듣기 좋은 내레이션을 자신의 언어로 작성하세요. 소스의 정확한 숫자, 이름 및 인용문을 유지하고, 절대 지표를 지어내지 마세요. 단순화하더라도 진실성을 유지하세요.

음성: 기본값은 Kokoro입니다. 사용자가 더 자연스러운 음성을 원하거나, .env에 OPENROUTER_API_KEY가 있는 경우 Gemini TTS를 사용하세요(CLAUDE.md, "음성" 참조).

3. 시각적으로 만드세요

  • 실제 자료 우선: 소스 자체의 그림과 녹화물, 실제 UI(실행 중인 앱의 스크린샷 또는 녹화), 그리고 중요한 라인이 강조된 집중된 스니펫으로 보여주는 실제 코드(코드 벽은 절대 안 됩니다).
  • 그 외 모든 것은 사용자 정의 애니메이션 다이어그램: 흐름, 전/후, 아키텍처, 숫자가 올라가는 카운트, 비교. 모든 장면은 아이디어를 설명하고 단어와 동기화되어 움직이는 무언가가 있어야 합니다.
  • 테마: 소스의 브랜드와 일치시키세요. 브랜드가 없는 코드의 경우, 제품의 모양이나 깔끔하고 코드 친화적인 테마를 사용하세요.

4. 확인한 후 전달하세요

CLAUDE.md에 있는 확인 → 스틸 컷 → 프리뷰 → 전체 렌더링 루프를 따르세요. 스틸 컷을 보고 겹침, 빈 공간, 읽을 수 없는 텍스트, 단어와 일치하지 않는 타이밍 등 보이는 문제를 수정하세요. 그런 다음 보고하세요: 출력 경로, 길이, 영상이 다루는 내용, 확인한 사항, 그리고 모든 가정이나 간격. 영상을 처음부터 끝까지 시청하지 않았다고 솔직히 말하세요.

스튜디오를 더 좋게 남기세요

재사용 가능한 주의 사항을 발견하면 CLAUDE.md에 추가하세요. 다른 영상에서도 필요로 할 만한 것(코드 diff 장면, PR 타임라인, 차트 기본 요소)을 만들었다면 lib/ 또는 templates/default로 옮기세요. videos/*/public/에 있는 생성된 에셋은 gitignored되므로, 새 클론이 재생성할 수 없는 것(다운로드한 미디어, 수제 이미지)은 스크립트로 가져와야 하며, 단순히 넣어두면 안 됩니다.

관련 스킬