video-merger

Merge multiple video files into a single output using ffmpeg.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/jacexh/skills --skill video-merger
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: video-merger
Source: https://github.com/jacexh/skills/tree/main/skills/video-merger
Command: npx skills add https://github.com/jacexh/skills --skill video-merger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill simplifies combining multiple video files or directory batches into a single playable file, removing the manual work of stitching clips together.

Core Features & Use Cases

  • Fast concat merging: Uses ffmpeg's concat demuxer with stream-copy to merge files without re-encoding when stream parameters match.
  • Directory and sorting support: Accepts explicit file lists or an entire directory with natural filename or modification-time sorting.
  • Practical use cases: Stitching meeting recordings, joining segmented camera clips, or assembling exported lesson videos into a single deliverable.

Quick Start

Run the merge_videos.py script to combine selected video files or all videos in a directory into a single output file named merged_output.mp4.

Frequently Asked Questions about video-merger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I merge video files without re-encoding using ffmpeg?▼

To merge video files without re-encoding, use the ffmpeg concat demuxer with stream-copy to combine clips when stream parameters match. This Skill automates that process by generating the concat file list and executing the merge script directly.

Can I batch merge all video clips in a directory?▼

Yes, you can batch merge video clips by passing a directory path to the merge script. It applies natural filename or modification-time sorting to concatenate all supported video files into a single output file.

Why does ffmpeg concat fail when merging recordings?▼

The concat demuxer fails when stream parameters like codec, resolution, or frame rate differ across input files. This Skill reports these failures, indicating that re-encoding is required to stitch the mismatched video segments together.

Do I need ffmpeg installed to concatenate video files?▼

Yes, ffmpeg must be installed and available on the PATH to concatenate video files. This Skill relies on the ffmpeg concat demuxer to perform fast stream-copy merges without requiring a full video re-encode.

What is the best way to stitch segmented meeting recordings into one file?▼

The best way to stitch segmented meeting recordings is using a concat demuxer script that stream-copies matching video parameters. This quickly assembles exported lesson videos or camera clips into a single deliverable file without quality loss.

How does natural sorting work when merging video clips in a directory?▼

Natural sorting orders video clips by interpreting multi-digit numbers in filenames as numerical values rather than ASCII characters. This ensures segment_2.mp4 is merged before segment_10.mp4 when concatenating an entire directory.