AI 스킬마트스킬 둘러보기명령어프로그램배우기스킬이 뭐예요?
 
← 목록으로

영상 해설 보이스오버 (video-voiceover)

타임스탬프가 붙은 나레이션 원고를 구간별 TTS 음성으로 합성하고, 각 시간창에 맞게 속도·음량을 조정해 합성용 메타데이터까지 남겨주는 스킬입니다.

이미지·영상고급★ 595⑂ 109AI 점수 8/10마지막 업데이트: 2026. 10. 21.

무엇을 해주나

  • narration.json(각 구간의 start/end/narration)을 읽어 구간마다 개별 WAV를 생성합니다.
  • 시간창을 넘지 않도록 말속도를 동적으로 맞추고, 라우드니스를 정규화합니다.
  • 결과는 tts_segments/*.wav와 tts_meta.json(엔진·음색·구간 배치 정보, 실패 목록)으로 정리됩니다.
  • 엔진은 MiMo TTS(기본), Fish Audio, 자체 호스팅 IndexTTS 중 선택할 수 있고, auto는 키 존재 여부로 MiMo→Fish 순으로 고릅니다.
  • 텍스트·설정·파일 크기/수정시각이 모두 같을 때만 기존 음성을 재사용하는 캐시 규칙이 있어 재합성 비용을 아낍니다.
  • --preserve-approved-text로 승인된 원고를 임의 축약 없이 보호하고, 창을 초과하면 증거와 함께 실패 처리합니다.

이런 분께 추천

  • 유튜브 리캡·요약 영상에 해설 보이스오버를 자동으로 넣고 싶은 제작자
  • 이미 컷 편집이 끝난 타임라인에 맞춰 나레이션 음성을 정확히 얹어야 하는 편집자
  • MiMo TTS 또는 Fish Audio API를 쓰고 있고, 파이프라인에 TTS 단계를 붙이려는 개발자

활용 예시

  1. python3 scripts/voiceover.py --work-dir work --narration work/narration.json — 기본 MiMo 엔진으로 전체 구간 음성 생성.
  2. TTS_PROVIDER=fish-audio FISH_API_KEY=... python3 scripts/voiceover.py --work-dir work — Fish Audio 무료 모델로 특정 음색 사용.
  3. 승인된 자막 원고를 그대로 읽히고 싶을 때 --preserve-approved-text를 붙여 축약 없이 합성, 시간 초과 구간은 실패 리포트로 확인.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/zenstory-ai/video-recap-skills/HEAD/skills/video-voiceover/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

AI 스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 zenstory-ai/video-recap-skills 의 skills/video-voiceover 폴더를 내 ~/.claude/skills/video-voiceover/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/zenstory-ai/video-recap-skills.git && mkdir -p ~/.claude/skills && cp -r video-recap-skills/skills/video-voiceover ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 원하는 작업 폴더로 이동합니다.
  2. git clone https://github.com/zenstory-ai/video-recap-skills.git 으로 저장소를 내려받습니다.
  3. mkdir -p ~/.claude/skills 로 스킬 디렉터리를 만듭니다.
  4. cp -r video-recap-skills/skills/video-voiceover ~/.claude/skills/ 로 스킬을 복사합니다(같은 파이프라인의 다른 스킬도 함께 복사하면 좋습니다).
  5. Python 3와 저장소의 의존성(ffmpeg 등)을 설치합니다.
  6. API 키를 설정합니다: export MIMO_API_KEY=... 또는 Fish Audio를 쓸 경우 export TTS_PROVIDER=fish-audio, export FISH_API_KEY=....
  7. Claude Code를 재시작한 뒤 "이 narration.json으로 해설 더빙해줘"처럼 요청하면 스킬이 동작합니다.
GitHub에서 원본 보기 ↗라이선스: MIT