跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
视频与音频

video-merge

Merges multiple videos from a folder (sorted by filename) into one clip with a random xfade transition (0.5s) between each pair; freeze-pads so total duration equals the sum of sources. Exports 3840×2160 60fps H.265 Main10 40Mbps + AAC 320kbps. Use when the user wants video merge, concatenate videos, video concat, transition animation, xfade, join clips, or batch stitch clips with transitions.

godot-fun · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add godot-fun/godot-agent --skill video-merge

技能说明


name: video-merge description: >- Merges multiple videos from a folder (sorted by filename) into one clip with a random xfade transition (0.5s) between each pair; freeze-pads so total duration equals the sum of sources. Exports 3840×2160 60fps H.265 Main10 40Mbps + AAC 320kbps. Use when the user wants video merge, concatenate videos, video concat, transition animation, xfade, join clips, or batch stitch clips with transitions. disable-model-invocation: true

Video Merge

Concatenate every video in a folder (filename sort) into one high-quality MP4. Between each pair, pick a random FFmpeg xfade transition (0.5s). Audio uses matching acrossfade.

Duration is preserved: each cut freeze-pads the outgoing clip by 0.5s (last frame + silence) before the overlap, so output length equals the sum of source clip durations (not shortened by transitions).

Rules

When this skill applies, read and follow skill-dependency-manager — run scripts as documented, install missing tools into .dependency/.

  • Run merge.py through .dependency/python/python.exe. Never use host python / ffmpeg.
  • Never overwrite sources. Outputs go under video-merge/.
  • Use the bundled script — do not hand-write equivalent FFmpeg commands.
  • Folder input only — pass --folder with a directory of clips (top-level files; no recurse).

Quick Start

.dependency/python/python .ai/video-merge/merge.py --folder path/to/clips

Example:

assets/shots/
  01.mp4
  02.mp4
  03.mp4
→ assets/shots/video-merge/shots.mp4

Output Spec (fixed)

SettingValue
Resolution3840×2160 (scale + letterbox pad)
Frame rate60 fps
VideoH.265 Main10 (libx265, yuv420p10le) @ 40 Mbps
AudioAAC 320 kbps, 48 kHz stereo
Transition0.5 s, random from the pool below (freeze-pad; duration preserved)
Container.mp4 (hvc1 tag)

Transition Pool (random per cut)

fade · dissolve · wipeleft · wiperight · wipeup · wipedown · slideleft · slideright · circlecrop · pixelize · distance · radial · smoothleft · smoothright · circleopen · circleclose · diagtl · diagtr · hblur · zoomin

Each cut independently samples one transition. Printed in the run log.

Common Flags

--folder · -o / --output

.dependency/python/python .ai/video-merge/merge.py --folder clips
.dependency/python/python .ai/video-merge/merge.py --folder clips -o out/final.mp4

Never overwrite source files. Input must be a folder (--folder), not a single video file. Only top-level videos in the folder (no recurse). Supported: .mp4, .mkv, .mov, .avi, .webm, .wmv, .flv, .m4v, .mpeg, .mpg, .ts, .mts, .m2ts, .3gp, .ogv.

Agent Notes

  1. Use the bundled script — do not hand-write ffmpeg xfade chains.
  2. Transition duration is fixed at 0.5s — no duration override flag.
  3. Every clip except the first must be longer than 0.5s (incoming side of xfade).
  4. Single file in the folder → re-encode to the output spec with no transition.
  5. Many clips (4K10) auto-chunk (max 4 inputs per filtergraph) to avoid OOM; transitions stay correct across chunk boundaries.
  6. Missing Python/FFmpeg → populate .dependency/ per skill-dependency-manager, retry.
  7. FFmpeg filter details: reference.md

Tests

From repo root:

.dependency/python/python .ai/video-merge/test_merge.py

Manual CLI examples: cli/video-merge.md