비디오 해설 스크립트 (video-script)
이미 분석된 영상 데이터를 바탕으로 연출·편집 기획과 타임스탬프 해설 원고를 작성하고 자동 검증까지 수행하는 스킬입니다.
이미지·영상고급★ 482⑂ 93AI 점수 8/10마지막 업데이트: 2026. 8. 28.
무엇을 해주나
영상 이해 분석(VLM/ASR)이 끝난 작업 폴더(work_dir)를 읽어 리캡·해설 영상의 창작 단계를 대신 진행합니다.
- 역할 분담 강제: 에이전트가 감독 → 스토리 에디터 → 화면 편집자 → 사운드/내레이션 에디터 → 첫 관객 순으로 판단하도록 절차화
- 산출물 구조화:
recap_story_plan.json(연출 의도·POV·비트),visual_audio_board.json(컷 인/아웃,audio_owner,narration_job), 선택적style_card.json - 모드 분리: full 모드는 원본 타임코드로 바로 해설 작성, cut 모드는 1단계
clip_plan.json→ 2단계 편집본 기준 해설 - 검증 파이프라인:
review.py로 환각·사실 오류 등 의미 검토,validate.py로 시간·무음 구간 정합성 하드 체크 및 정렬 - 작성 규칙: 내레이션은 context/causal_link/foreshadow/interpretation/transition/none 중 명확한 임무가 있을 때만 작성, '화면 설명하기' 금지, 원음·침묵에 소리 주도권 양보
이런 분께 추천
- 드라마·영화 리캡, 유튜브 해설 영상을 반복 제작하는 크리에이터
- 같은 저장소(video-recap-skills)의 영상 분석 파이프라인을 이미 쓰고 있는 분
- 내레이션 품질을 사람 감수 없이 일정 수준으로 고정하고 싶은 편집 팀
활용 예시
- 첫 창작(CREATE): 분석이 끝난 40분짜리 드라마 회차에 대해 "해설 써줘"라고 요청 → 두 가지 구성 가설 비교 후 POV·비트 확정, 비트별 화면/원음/내레이션 분담표 생성, 타임스탬프 해설 초안 작성
- 10분 컷 편집: cut 모드 1단계에서
clip_plan.json에beat_id | function | change | POV | 인점 | 출점형식 근거를 붙여 클립 목록 생성 → 편집본 생성 후 출력 타임라인 기준으로 내레이션 재작성 - 수정 요청(REVISION): "3번 비트 말투가 너무 딱딱하다"는 피드백 →
style_card.json만 갱신하고 나머지 비트는 동결, 이후review.py/validate.py재실행으로 클린 상태 확인
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/zenstory-ai/video-recap-skills/HEAD/skills/video-script/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-script 폴더를 내 ~/.claude/skills/video-script/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/zenstory-ai/video-recap-skills.git && mkdir -p ~/.claude/skills && cp -r video-recap-skills/skills/video-script ~/.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-script ~/.claude/skills/ python3 --version으로 파이썬 3가 설치되어 있는지 확인합니다(review.py,validate.py실행에 필요).- Claude Code를 재시작하고
/skills또는 "해설 써줘" 같은 트리거로 스킬이 인식되는지 확인합니다. - 중요: 이 스킬은 단독으로 쓰지 않습니다. 같은 저장소의 영상 분석 스킬을 먼저 실행해
work_dir안에agent_narration_brief.md,vlm_analysis.json,recap_run_manifest.json이 생성된 뒤에 호출하세요.
GitHub에서 원본 보기 ↗라이선스: MIT