video-assemble (Final Video Assembly)
Final-stage skill that mixes narration audio onto source video with ducking, generates and burns subtitles, and normalizes loudness into a finished recap file.
Image & VideoAdvanced★ 470⑂ 86AI score 7/10Last updated: Aug 24, 2026
What it does
- Places each narration audio segment onto the source video timeline at exact positions from
tts_meta.json. - Ducks the original audio inside narration windows, with fixed / sidechain / zone ducking modes and configurable fades.
- Generates
subtitles.srtplussubtitles.ass, burning them in by default (--no-burn-subtitlesto disable). - Normalizes final loudness to a target LUFS and emits verification artifacts:
timeline.json,assembly_manifest.json,assembly_qc.json. - Optionally exports an editable CapCut/剪映 draft project referencing the real source clips.
Who it's for
- Creators mass-producing recap/commentary videos through an automated pipeline.
- Video engineers who want ffmpeg mixing and subtitle rendering handled reproducibly in code.
- Users already running the sibling video-recap skills (script → TTS → cut editing) from the same repo.
Examples
- "Assemble source.mp4 with the narration in work_dir and burn the subtitles" → produces
recap_*.mp4. - "Original dialogue matters in this scene: reduce ducking depth and add no BGM" → tune
SPEECH_DUCKING_VOLUME, leaveBGM_PATHunset. - "I want to polish the result in CapCut" → run with
--export-jianying --source-video orig.mp4.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/zenstory-ai/video-recap-skills/HEAD/skills/video-assemble/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/video-assemble folder from the GitHub repo zenstory-ai/video-recap-skills into my ~/.claude/skills/zenstory-ai-video-assemble/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/zenstory-ai/video-recap-skills.git && mkdir -p ~/.claude/skills && cp -r video-recap-skills/skills/video-assemble ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and go to your working directory.
- Clone the repo:
git clone https://github.com/zenstory-ai/video-recap-skills.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r video-recap-skills/skills/video-assemble ~/.claude/skills/ - Since this is the last pipeline stage, also copy the upstream skills from the repo (scripting, TTS, cut editing).
- Check prerequisites:
python3 --version, andffmpeg -filters | grep subtitlesto confirm libass support (burn-in fails without it). - Restart Claude Code, then ask for "assemble the video" / "burn subtitles" to trigger it.
View source on GitHub ↗License: MIT