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.

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/hahadu4520/vlog-cut --skill narration-cut

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

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
del mismo repositorio

Más Skills

Todos los Skills
hahadu4520
Comunidad

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.

Instalaciones / 1h
1
GitHub Stars
49
Actualizado
8 may
hahadu4520
Comunidad

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.

Instalaciones / 1h
1
GitHub Stars
49
Actualizado
8 may
hahadu4520
Comunidad

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

Instalaciones / 1h
1
GitHub Stars
49
Actualizado
8 may
hahadu4520
Comunidad

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.

Instalaciones / 1h
1
GitHub Stars
49
Actualizado
8 may