Communitygithub.com

carlosa54/explainer-video

나레이션, 애니메이션 설명 동영상 생성 (3Blue1Brown 스타일 Manim 다이어그램, 실제 앱 스크린샷, ElevenLabs 음성, 동기화된 자막). 설명 또는 워크스루 동영상을 만들거나, 기존 동영상을 재편집/단축하거나, 내레이션 음성을 변경하라는 요청 시 사용됩니다.

explainer-video란 무엇인가요?

이 스킬은 개발자가 코드 저장소, 앱 스크린샷, Manim 애니메이션을 사용하여 전문적인 내레이션 설명 동영상을 제작할 수 있게 해줍니다. 전체 파이프라인은 프로젝트 폴더 내에서 관리되며, 음성 합성은 ElevenLabs API를, 애니메이션은 Manim 라이브러리를 사용합니다. 가장 큰 특징은 '컷(cut)' 중심의 반복 작업 워크플로우로, 사용자가 기존 동영상을 복제하고, 편집하며, 다양한 버전(새로운 음성, 짧은 편집 등)을 만들 때도 이전 결과물은 그대로 유지되고 변경된 부분만 비용이 발생한다는 점입니다. 스킬은 사실 시트 수집 → 프로젝트 초기화 → 스크립트 작성 → 드래프트 오디오 기반 애니메이션 → 실제 음성 합성 → 최종 빌드/검증 → 전달의 7단계로 구성되어 있으며, 각 단계마다 상세한 체크포인트와 참조 문서를 제공합니다. Claude Code, Codex, Cursor 등 AI 어시스턴트가 사용자 요청을 이해하고 반자동으로 동영상 제작 과정을 안내할 수 있도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/carlosa54/explainer-video/tree/HEAD/skills/explainer-video

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

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

문서

설명 동영상 (Explainer Video)

완성된 설명 동영상은 단어에 따라 그림이 움직이는 MP4입니다: 각 애니메이션은 내레이터가 설명하는 구절에 도달할 때 시작되며, 자막은 음성 자체의 문자 타임스탬프를 기준으로 시간이 맞춰집니다. 작업은 프로젝트 폴더 내의 파이프라인으로 구성됩니다: narration.py (스크립트), scenes.py (Manim 장면), video.json (제목, 음성), screens/ (스크린샷), kit/ (벤더드 툴킷, 프로젝트 루트에서 python -m kit <command>로 실행).

모든 컷(새 버전, 단축 편집, 새 음성)은 scripts/new_project.py DEST --from OLD로 만든 새 프로젝트 폴더입니다. 이전 컷은 재생 가능하며 변경되지 않은 상태로 유지됩니다; 합성된 문장은 프로젝트 외부의 콘텐츠에 의해 캐시되므로, 컷은 변경된 문장에 대해서만 비용이 발생합니다.

API 키는 환경 변수 ELEVENLABS_API_KEY에서 가져옵니다. 사용자가 사용하는 시크릿 관리자(op run --, av inject +ELEVENLABS_API_KEY --, 일반 export)를 통해 음성 명령을 실행하세요; 키를 출력, 로깅 또는 작성하지 마세요.

단계

1. 사실 시트 (Facts sheet)

사용자의 브리핑, 저장소 및 설정, 사용자에게 질문하여 동영상이 주장할 내용을 수집합니다. 각 주장을 확인됨(설정, 화면 또는 사용자의 말에서 확인) 또는 예시용(자리 표시자, 예시, 개념적 레이아웃)으로 기록합니다. 시청자, 목표 길이, 그리고 반드시 잘라내야 할 내용을 명확히 합니다.

계획한 모든 화면상 또는 음성상의 주장이 확인된 내용으로 추적 가능하고, 예시용 주장들은 결과 노트에 나열되면 완료됩니다. 가장 자주 잘못되는 주장들은 references/script.md를 참조하세요.

2. 프로젝트 (Project)

새 동영상은 python3 <skill>/scripts/new_project.py DEST, 새 컷은 --from OLD를 사용합니다. template/requirements.txt를 venv에 설치합니다(Manim은 시스템에 Cairo, Pango 및 ffmpeg가 필요합니다). video.json에서 name, title, voice를 설정합니다.

python -m kit draft && python -m kit build --low가 번들된 예제(또는 복사된 컷)를 out/에 빌드하면 완료됩니다.

3. 스크립트 (Script)

narration.py를 작성합니다: 재생 순서대로 장면을 배치하고, 각 장면은 (id, caption, spoken) 세그먼트(1~3문장)의 목록입니다. 분당 약 150단어를 목표로 예산을 잡고, 음성을 빠르게 하기보다 실제 오디오가 최종 길이를 결정하도록 합니다. 이름의 발음은 pronunciations.json에 넣습니다.

스크립트를 표(장면, 내레이션, 화면에 표시할 내용)로 사용자에게 보여주고 사용자만이 답할 수 있는 질문을 합니다. 사용자가 문구를 승인하면 완료됩니다: 합성에는 비용이 들지만, 그 전에 스크립트를 편집하는 것은 무료입니다.

4. 드래프트 오디오로 애니메이션 (Animate on draft audio)

python -m kit draft는 균일한 문자 타이밍으로 무료 자리 표시자 내레이션을 만들어 음성 비용을 지불하기 전에 장면을 배치할 수 있게 합니다. scenes.py에 장면당 하나의 Narrated(다이어그램) 또는 ScreenScene(스크린샷) 클래스를 작성하고, say / until / done으로 모든 변경을 구동합니다. python -m kit build --low로 반복하고 프레임을 확인합니다.

모든 세그먼트가 단어에 따라 변하는 그림을 가지고 있고, python -m kit timing이 침묵 간격을 보고하지 않으며, 낮은 해상도 미리보기에서 겹치는 텍스트나 빈 스테이지가 없으면 완료됩니다. 장면을 작성하기 전에 references/animation.md를 읽고, 라이브 앱을 캡처하기 전에 references/screens.md를 읽으세요.

5. 음성 (Voice)

음성을 선택하지 않은 경우 오디션: python -m kit voices, 그런 다음 어려운 이름이 포함된 문장으로 python -m kit audition ID1 ID2 ID3를 실행하고 사용자가 직접 듣고 선택하도록 합니다. 그런 다음 python -m kit narrate --dry-run으로 문자 비용을 확인하고 python -m kit narrate를 실행합니다.

narrate가 합성할 세그먼트가 0개라고 보고하면 완료됩니다. 음성 설정, 복제된 음성, 크레딧 및 키 권한에 대해서는 references/narration.md를 읽으세요.

6. 빌드 및 확인 (Build and verify)

python -m kit build(전체 해상도), 그런 다음 python -m kit verify --speech. out/의 연락처 시트와 모든 장면의 전체 해상도 프레임을 검토하고 발견된 문제를 수정합니다. 새 음성은 템포를 변경하므로, 음성 교체는 항상 전체 재렌더링을 의미하며 사운드트랙 교체로 대체할 수 없습니다.

references/verify.md의 모든 검사가 통과되거나 해당 예외가 설명되면 완료됩니다.

7. 전달 (Deliver)

MP4, SRT, 스크립트 및 연락처 시트의 절대 경로; 길이; 음성 및 모델; 확인 번호; 1단계의 예시용 또는 미확인 목록; 재빌드 명령을 보고합니다. 드래프트 오디오를 완성된 내레이션이라고 부르지 마세요: assemble은 어떤 세그먼트라도 드래프트 상태인 동안 최종 빌드를 거부합니다.

관련 스킬