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.

Voir la source

Mode d’emploi

  1. Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
  2. Consultez le document original pour les outils, identifiants et environnements requis.
  3. Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/hahadu4520/vlog-cut --skill narration-cut

Avant de commencer

  • L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
  • Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

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
du même dépôt

Autres Skills

Tous les Skills
hahadu4520
Communauté

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.

Installations / 1h
1
GitHub Stars
49
Mis à jour
8 mai
hahadu4520
Communauté

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.

Installations / 1h
1
GitHub Stars
49
Mis à jour
8 mai
hahadu4520
Communauté

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).

Installations / 1h
1
GitHub Stars
49
Mis à jour
8 mai
hahadu4520
Communauté

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.

Installations / 1h
1
GitHub Stars
49
Mis à jour
8 mai