Video Transition

视频转场效果工具。使用 ffmpeg xfade 滤镜实现多种转场效果，包括淡入淡出、滑动、擦除、圆形展开等。 支持批量视频片段合并，自动添加转场效果。

Security Scan

The skill is an ffmpeg-based video transition utility whose code and instructions match its stated purpose; there are only minor metadata/inventory inconsistencies to be aware of.

Purpose & Capability

The SKILL.md and Python code implement an ffmpeg-based video transition tool (concat, xfade, fade). This requires ffmpeg/ffprobe, which the documentation declares, but the registry metadata incorrectly lists no required binaries — a minor inconsistency (the functionality itself matches the name/description).

Instruction Scope

Runtime instructions and code restrict actions to invoking ffmpeg/ffprobe on user-supplied files, creating a temporary list file for concat, and writing outputs to provided paths. The SKILL.md does not request unrelated data or system access.

Install Mechanism

No install spec (instruction-only with included Python module). No network downloads or archive extraction. The package contains a package.json (for metadata) but the implementation is Python — odd but not dangerous.

Credentials

The skill requests no environment variables, credentials, or config paths. It operates on local files and external ffmpeg binaries only, which is proportional to its purpose.

Persistence & Privilege

Skill does not request persistent/always-on privileges; it is user-invocable and may be invoked autonomously per platform defaults. It does not modify other skills or system-wide configs.

Assessment

This skill appears to do what it says: it calls ffmpeg/ffprobe to add transitions and fades to local video files. Before installing, ensure you have ffmpeg (>=4.0) and ffprobe on PATH, and run the code on trusted input files. Note two small inconsistencies: the registry metadata does not declare the required ffmpeg binary, and SKILL.md mentions a README.md that is not present — neither affects functionality but you may want to confirm the source is trustworthy. If you run it in an environment with sensitive files, avoid pointing it at directories containing secrets or system files (it operates on paths you supply).

Video Transition / 视频转场

视频转场效果工具，使用 ffmpeg xfade 滤镜实现平滑转场。

支持的转场效果

转场类型	英文名	效果描述
淡入淡出	fade	画面逐渐过渡
左滑	slideleft	新画面从右侧滑入
右滑	slideright	新画面从左侧滑入
上滑	slideup	新画面从下方滑入
下滑	slidedown	新画面从上方滑入
圆形展开	circleopen	圆形遮罩展开
左擦除	wipeleft	从右向左擦除
右擦除	wiperight	从左向右擦除
距离	distance	距离渐变
像素化	pixelize	像素化过渡
对角线	diagtl/diagtr	对角线擦除
矩形	rectcrop	矩形裁剪

快速使用

1. 合并视频带转场

from video_transition import concat_with_transitions

# 合并视频片段，自动添加转场
concat_with_transitions(
    video_paths=["clip1.mp4", "clip2.mp4", "clip3.mp4"],
    output_path="output.mp4",
    transition_duration=0.5
)

2. 单个转场效果

from video_transition import apply_transition

# 在两个视频之间应用特定转场
apply_transition(
    video1="intro.mp4",
    video2="main.mp4",
    output="merged.mp4",
    transition="fade",
    duration=0.5
)

3. 批量添加淡入淡出

from video_transition import add_fade_to_clips

# 为所有片段添加淡入淡出
add_fade_to_clips(
    input_dir="clips/",
    output_dir="faded/",
    fade_in=0.3,
    fade_out=0.3
)

参数说明

concat_with_transitions()

参数	类型	默认值	说明
video_paths	list	-	视频路径列表
output_path	str	-	输出路径
transition_duration	float	0.5	转场时长（秒）
transitions	list	循环使用所有	转场类型列表
auto_fade	bool	True	是否自动添加淡入淡出

apply_transition()

参数	类型	默认值	说明
video1	str	-	第一个视频
video2	str	-	第二个视频
output	str	-	输出路径
transition	str	"fade"	转场类型
duration	float	0.5	转场时长
offset	float	自动计算	转场起始时间

依赖

ffmpeg >= 4.0

技术原理

使用 ffmpeg 的 xfade 滤镜实现视频转场：

ffmpeg -i clip1.mp4 -i clip2.mp4 \
  -filter_complex "[0:v][1:v]xfade=transition=fade:duration=0.5:offset=5[outv]" \
  -map "[outv]" output.mp4

触发词

视频转场、转场效果、xfade、视频合并、淡入淡出

文件结构

video-transition/
├── SKILL.md              # 技能说明
├── README.md             # 详细文档
├── video_transition.py   # 核心模块
├── example.py            # 使用示例
└── package.json          # 包信息

License

MIT

Author

systiger