hahadu4520/vlog-cut

narration-cut

Use when narration audio (timing.json + narration.wav) and an indexed asset pool (assetsindex.json) exist, and the user wants a rough cut.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/hahadu4520/vlog-cut --skill narration-cut

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

narration-cut

Three CLIs, used in sequence. Each is also fine to call alone.

stepCLIwhat it does
planvlog-cut-plantiming + assets → draft timeline.json (algorithmic)
validatevlog-cut-validatestructural + temporal sanity check on timeline.json
rendervlog-cut-rendertimeline + narration → rough_cut.mp4

When to use

Trigger on:

  • "对齐镜头 / 排时间线 / 出粗剪"
  • "cut to narration / build timeline / render the rough cut"
  • the user has both timing.json and assets_index.json and wants a video

Skip when:

  • either timing or assets index is missing — go back to tts-from-script or video-asset-index
  • the user wants subtitles only — that's burn-subtitles-cn (v0.2)

Step 1 — plan (draft a timeline)

bash
vlog-cut-plan \
  --timing  <out>/timing.json \
  --assets  <out>/assets_index.json \
  --out     <out>/timeline.json \
  --size    1920x1080 \
  --fps     30

The algorithm scores clips by chapters match, tag overlap with the section, highlight bonus, and a "already used" penalty for variety. It's a starting point, not a final answer.

The expected workflow is: Claude reads timeline.json, opens the relevant sheets/<stem>.jpg for any shot it's unsure about, then rewrites timeline.json by hand to swap in better picks. This is a checkpoint — don't render until the user has signed off.

Step 2 — validate (before you render)

bash
vlog-cut-validate \
  --timeline <out>/timeline.json \
  --src      <clips_folder> \
  --timing   <out>/timing.json   # optional but recommended

Catches:

  • missing source clips
  • in + dur exceeding source duration
  • shots not covering line audio (video would end first)
  • duplicate / mismatched line ids

Exit code: 0 = clean, 1 = warnings only, 2 = errors. Don't render on exit 2.

Step 3 — render (make the mp4)

bash
vlog-cut-render \
  --timeline  <out>/timeline.json \
  --timing    <out>/timing.json \
  --src       <clips_folder> \
  --narration <out>/narration.wav \
  --out       <out> \
  --name      rough_cut.mp4

Optional:

  • --size 1920x1080 — override timeline.size
  • --fps 30 — override timeline.fps
  • --name xxx.mp4 — output filename

Outputs:

<out>/
├── segs/        ← per-shot mp4 (cached on rerun)
├── video_silent.mp4
└── rough_cut.mp4

The render absorbs gap silences into the last shot of each line: if the source has room, dur is extended; otherwise the last frame is held (tpad). Result: the video stays populated through every silence.

Idempotency

segs/<idx>_<lid>_<stem>.mp4 is reused if it exists. To force a re-render of a single shot, delete that file. To force the whole video, delete segs/.

Checkpoint (when called from vlog-cut-pipeline)

Two checkpoints land in this skill:

  1. after plan — timeline_drafted → ask the user to approve the picks (or let Claude refine first, then approve)
  2. after render — rough_cut_rendered → ask the user to watch rough_cut.mp4

Don't proceed until both are approved.

Dependencies

  • ffmpeg / ffprobe on PATH
  • no Python deps beyond stdlib
같은 저장소의 Skills

더 많은 Skills

모든 Skills
hahadu4520
커뮤니티

align-narration

Use when the user has their OWN narration audio (m4a/mp3/wav) and needs the same timing.json + narration.wav that tts-from-script would emit. Calls whisper to transcribe, then groups segments into one line per section (using each section's optional headtext anchor in script.json). Triggers on "我自己录了配音 / 自带口播 / align my narration / 我有现成的录音". This is the v0.4 alternative to tts-from-script.

1시간 설치 수
1
GitHub Stars
49
업데이트
5월 8일
hahadu4520
커뮤니티

burn-subtitles-cn

Use when the user wants Chinese subtitles burned into a finished rough cut. Three CLIs — split (timing.json → paged subspages.json), build (subspages.json → ASS), burn (mp4 + ASS → mp4 with hard-burnt subs). Triggers on "加字幕 / 烧字幕 / burn subtitles / add Chinese subs". Designed for ≤12-char per-page Chinese subtitles with punctuation-priority line breaks.

1시간 설치 수
1
GitHub Stars
49
업데이트
5월 8일
hahadu4520
커뮤니티

tts-from-script

Use when the user has a narration script (script.json) and needs voiceover audio plus per-line timing data — synthesizes each line with edge-tts, probes durations, and writes timing.json + a merged narration.wav. Triggers on "做配音 / TTS / 文案配音 / 生成口播". Skip when the user already has their own narration audio (then use align-narration instead, planned for v0.4).

1시간 설치 수
1
GitHub Stars
49
업데이트
5월 8일
hahadu4520
커뮤니티

vlog-cut-pipeline

Use when the user wants to take a script + a folder of raw clips all the way to a finished rough cut. Orchestrates tts-from-script → video-asset-index → narration-cut (plan / validate / render), with FOUR mandatory human-review checkpoints between stages. Triggers on "做视频 / 剪个视频 / 把这段文案做成视频 / make a video from this script". Do NOT bypass the checkpoints — Claude pauses, the user approves, then the next stage runs. State is tracked in /.vlog-cut/state.json.

1시간 설치 수
1
GitHub Stars
49
업데이트
5월 8일