video-assemble (영상 최종 합성)
내레이션 오디오·원본 영상·자막을 합쳐 더킹과 라우드니스 정규화까지 마친 최종 리캡 영상을 뽑아내는 합성 단계 스킬.
이미지·영상고급★ 555⑂ 105AI 점수 7/10마지막 업데이트: 2026. 10. 4.
무엇을 해주나
- TTS로 만든 구간별 내레이션 오디오를 영상 타임라인 위에 배치하고, 내레이션 구간에서만 원본 사운드를 단계적으로 눌렀다가(ducking) 문장 끝 앵커에서 자연스럽게 복구합니다.
- 내레이션 위치를 기준으로
subtitles.srt/subtitles.ass를 생성하고 기본값으로 번인(하드섭)합니다. libass가 없으면 외부.srt전달로 자동 강등하고 경고를 기록합니다. - 2패스 loudnorm + 4배 오버샘플 트루피크 리미터로 목표 LUFS에 맞추고, AAC 인코딩 후 실측 트루피크가 -1 dBTP를 넘으면 오디오만 재인코딩해 재조정합니다.
timeline.json,assembly_manifest.json,assembly_qc.json등 검증·추적용 산출물과 선택적으로 剪映(CapCut 중국판) 초안 프로젝트를 내보냅니다.
이런 분께 추천
- 유튜브 리캡/요약 영상처럼 "원본 영상 + AI 내레이션" 포맷을 반복 제작하는 제작자
- ffmpeg 기반 자동 편집 파이프라인을 구축 중이며 믹싱·자막·라우드니스 기준을 코드로 고정하고 싶은 엔지니어
- 납품 품질 게이트(QC 리포트, 트루피크 한도)를 자동화하려는 영상 후반 작업자
활용 예시
python3 scripts/assemble.py source.mp4 --work-dir work/로 기본 narration 모드 합성 — 내레이션 배치, 더킹, 자막 번인, 라우드니스 정규화를 한 번에 수행.- 컷 편집본을 사용할 때
--source-video orig.mp4 --export-jianying을 붙여 剪映에서 열 수 있는 편집 가능한 초안으로 내보내기. - 자막 번인을 끄고 외부 자막으로 납품:
--no-burn-subtitles를 주면recap_<stem>.srt가 성과물 옆에 생성됩니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/zenstory-ai/video-recap-skills/HEAD/skills/video-assemble/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 zenstory-ai/video-recap-skills 의 skills/video-assemble 폴더를 내 ~/.claude/skills/zenstory-ai-video-assemble/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/zenstory-ai/video-recap-skills.git /tmp/video-recap-skills && mkdir -p ~/.claude/skills && cp -r /tmp/video-recap-skills/skills/video-assemble ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널에서 작업 폴더로 이동합니다.
- 저장소를 내려받습니다:
git clone https://github.com/zenstory-ai/video-recap-skills.git - 스킬 디렉터리를 생성합니다:
mkdir -p ~/.claude/skills - 이 스킬을 복사합니다:
cp -r video-recap-skills/skills/video-assemble ~/.claude/skills/- 파이프라인 전체를 쓰려면
skills/하위 다른 스킬도 함께 복사하세요.
- 파이프라인 전체를 쓰려면
- 사전 요구사항을 확인합니다:
ffmpeg -version실행 후 출력에--enable-libass,--enable-libfreetype가 있는지, 그리고python3 --version이 동작하는지 점검합니다. - Claude Code를 재시작한 뒤 "영상 합성해줘", "자막 번인하고 믹스해줘" 같이 요청하면 스킬이 로드됩니다(이 스킬은 파이프라인 내부 단계라 상위 단계의
tts_meta.json이 필요합니다).
GitHub에서 원본 보기 ↗라이선스: MIT