Design & media

ffmpeg剪辑大师

使用 FFmpeg 进行多媒体编辑，包括视频剪辑、拼接、转码、特效、截图、水印、变速、音频处理等 20 种操作。当用户提到"FFmpeg""视频剪辑""视频拼接""视频压缩""视频格式转换""截图""水印""变速""倒放""GIF""音频提取""音频降噪""音量调节""画中画""裁剪""旋转""字幕""过渡特效"...

What it does

The skill document

FFmpeg 多媒体编辑工具箱

使用 FFmpeg 对本地视频和音频文件进行编辑处理，支持 20 种常用操作。本 Skill 不调用任何外部 API，所有处理在本地完成。

适用场景：

用户需要对视频文件进行剪辑、拼接、转码、压缩、加特效等操作
用户需要从视频中提取音频、截图、获取首尾帧
用户需要添加字幕、水印、画中画等叠加效果
用户需要音频拼接、提取、降噪、音量调节
用户需要进行视频和 GIF 之间的转换
用户需要变速（慢动作/加速）、倒放、分段拆分

使用脚本

脚本位于 skill 目录内的 scripts/，运行时始终使用绝对路径。

设 FFMPEG_SKILL_DIR 为 .claude/skills/ffmpeg-multimedia-editing 的绝对路径。

视频操作

功能	脚本	关键参数
字幕	`video_subtitle.py`	`--input`, `--subtitle` , `--mode soft\|hard`
视频拼接	`video_concat.py`	`--inputs a.mp4 b.mp4 ...`
截图	`video_screenshot.py`	`--input`, `--time`, `--interval`, `--count`
获取首尾帧	`video_firstlast_frame.py`	`--input`
过渡特效	`video_transition.py`	`--inputs a.mp4 b.mp4`, `--type fade\|dissolve`, `--duration`
视频剪辑	`video_trim.py`	`--input`, `--start`, `--end`
格式转换	`video_convert.py`	`--input`, `--format webm`
压缩/缩放	`video_compress_scale.py`	`--input`, `--resolution 720p`, `--crf 28`
变速	`video_speed.py`	`--input`, `--speed 0.5`
水印	`video_watermark.py`	`--input`, `--watermark` , `--position top-right`
裁剪/旋转/翻转	`video_crop_rotate.py`	`--input`, `--crop WxH+X+Y`, `--rotate 90`, `--flip h\|v`
画中画	`video_pip.py`	`--main`, `--overlay`, `--position bottom-right`
倒放	`video_reverse.py`	`--input`
分段拆分	`video_split.py`	`--input`, `--segment-duration 60`
视频/GIF互转	`video_gif_convert.py`	`--input`, `--to gif\|mp4`
音画合成	`video_image_compose.py`	`--images` , `--duration 5`, `--audio`

音频操作

功能	脚本	关键参数
音乐拼接	`audio_concat.py`	`--inputs a.mp3 b.mp3 ...`
音频提取/替换	`audio_extract_replace.py`	`--input video.mp4`, `--extract-audio`
音量调节	`audio_volume.py`	`--input`, `--volume 1.5`, `--normalize`
音频降噪	`audio_denoise.py`	`--input`, `--strength medium`

快速调用

# 截图
uv run --python python $FFMPEG_SKILL_DIR/scripts/video_screenshot.py --input video.mp4 --time 00:01:30

# 视频拼接
uv run --python python $FFMPEG_SKILL_DIR/scripts/video_concat.py --inputs a.mp4 b.mp4 c.mp4

# 音频提取
uv run --python python $FFMPEG_SKILL_DIR/scripts/audio_extract_replace.py --input video.mp4 --extract-audio

# 字幕嵌入
uv run --python python $FFMPEG_SKILL_DIR/scripts/video_subtitle.py --input video.mp4 --subtitle subs.srt

输出约定

本地输出目录：outputs/ffmpeg//（相对于 OUTPUT_ROOT，默认为项目根目录）
所有脚本输出 JSON 至少包含：
- type — video / audio / image
- operation — 操作名称（如 subtitle, concat, trim）
- local_path — 输出文件路径
- input_path — 输入文件路径
- elapsed_seconds — 处理耗时

配置

依赖：ffmpeg（full build 8.1+）和 ffprobe，需在 PATH 中可用
环境变量：OUTPUT_ROOT（可选，输出根目录，支持 ~ 展开，默认为用户主目录）
无需环境变量或外部 API 密钥
所有操作在本地执行，不涉及网络传输

协作方式

本 skill 为独立工具，可直接完成所有多媒体编辑操作
不与 content_generation_workflow 集成，也不依赖 AI 生成能力
如果用户需要将编辑后的文件上传为公网链接，可后续调用 qiniu skill 处理

Related skills

Byted Mediakit Editing

音视频剪辑，涵盖音视频拼接、裁剪、合成等能力。包含能力：add-image-to-video, add-subtitle-to-video, adjust-audio-speed, adjust-video-speed, adjust-video-volume, apply-video-filter, concat-audio, concat-video, extract-audio, fade-audio, fade-video-audio, flip-video, image-to-video, mix-audio, mux-audio-video, trim-audio, trim-vi

1 installs

Video Cut

End-to-end turn an unedited long-form talking-head / vlog / podcast video into a compact "first cut" (rough cut). Use when asked to edit/剪辑 a raw YouTube (or...

1 installs

audio-segmenter

当用户想要**把长音频切成小段**、**音频切片**、**音频分割**、**把音频分成固定时长片段**、**制作语音数据集**、**准备Karaoke素材**、**翻唱音频切片**时自动触发。支持单个音频文件或整个文件夹（支持递归），自动用 ffmpeg 把音频按指定秒数切成小片段，完美保留原始文件夹结构，并智能选择输出路径。常见触发口语： - “帮我把这个音频切成60秒一段” - “把这个长音频分割成小段” - “音频切片，这个文件夹” - “把语音文件切成每段30秒” - “制作数据集，把音频切片” - “Karaoke素材切片” - “翻唱音频分割” - “把MP3切成小段” -

21 installs