video-cut (영상 컷 편집)

무엇을 해주나

• clip_plan.json(원본 기준 start/end 목록)을 검증·정규화해 clip_id, 원본/출력 시간, 길이가 담긴 clip_plan_validated.json을 생성합니다.
• 선택 구간을 이어 붙여 edited_source.mp4를 출력합니다. 같은 입력이면 항상 같은 결과가 나오고, 결과물이 계획보다 새로우면 캐시를 재사용합니다.
• 컷 지점 안전 규칙이 핵심입니다. 원본 하드컷 근처의 플래시 프레임을 피하도록 씬 컷에 먼저 스냅하고, 마지막에 신뢰할 수 있는 문장 끝/자연 정지 지점으로 경계를 붙입니다. 대사가 잘리면 unsafe_clip_sentence_boundary로 작업을 차단합니다.
• 구간 중복 금지가 기본이며 --allow-overlap으로 해제할 수 있습니다. 연속 동일 소스 연결은 무손실로 처리하고, 비연속 지점만 팝 노이즈 방지 페이드를 넣습니다.
• 구형 단일 단계 경로에서는 원본 시간 기준 나레이션을 narration_mapped.json으로 매핑해 줍니다.

이런 분께 추천

• 드라마·영화 리캡(해설) 영상을 LLM 에이전트로 자동 제작하는 파이프라인을 만드는 분.
• ffmpeg 기반 자동 편집에서 "대사가 반토막 나는" 문제와 접점 부자연스러움을 규칙으로 통제하고 싶은 분.
• 중국어 문서와 파이썬/ffmpeg CLI 환경에 익숙한 중급~고급 사용자.

활용 예시

1. 이해 단계에서 만든 ASR 타임라인과 speech_boundary_anchors.json을 두고, 에이전트가 대략적인 10분 분량 구간 목록을 쓰면 python3 scripts/cut.py movie.mp4 --work-dir work --target-duration 10m --no-narration-map으로 컷 영상만 뽑고 이후 출력 타임라인 기준으로 나레이션을 작성.
2. 접점이 어색한지 점검할 때 ffmpeg -i input.mp4 -vf "select='gt(scene,0.35)',showinfo" -an -f null -로 후보 시점을 뽑아, 원본 자체의 짧은 컷인지 이번 이어붙이기로 생긴 컷인지 구분해 경계를 이동.
3. 중복 구간을 의도적으로 재사용하려면 --allow-overlap을 켜고 나레이션 문장에 source_clip_id를 명시해 어느 클립의 대사인지 구분.

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

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

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