FFmpeg应用指南

📌 Skill 基础信息

Skill 名称: ffmpeg-usage

简称: FFmpeg 多媒体处理

来源: 社区第三方 (ychoi-kr)

运行宿主: Claude-Code CLI

核心定位: 提供基于 FFmpeg 的完整多媒体处理解决方案，适用于视频格式转换、编辑优化、平台适配等常见音视频处理场景。

🧩 内部核心组成

本 Skill 主要包含预设的 FFmpeg 命令模板和最佳实践指南，无传统意义上的子Agent、斜杠命令或 MCP 工具。

核心能力模块:

• 格式转换（MP4/WebM/MOV 等互转）
• 分辨率调整与缩放处理
• GIF 创建与优化
• 音频提取与格式转换
• 视频剪辑（裁剪、拼接、变速、旋转）
• 字幕处理（烧录、软字幕、提取）
• 缩略图提取
• 压缩优化与平台专用预设

目录结构: 主要包含 Skill 配置文件和命令模板集合。

🛠 安装与启用方式

安装命令:

skills install --user ychoi-kr/claude-ffmpeg-skill

前置依赖:

• FFmpeg >= 4.0
• FFprobe（推荐但非必需）

系统安装要求:

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt-get install ffmpeg

# Windows (Chocolatey)
choco install ffmpeg

验证安装:

ffmpeg -version

📋 标准工作流

1. 用户输入多媒体处理需求（如格式转换、剪辑等）
2. Skill 识别任务类型并匹配预设命令模板
3. 验证环境检查 FFmpeg 安装和文件可访问性
4. 生成命令根据具体需求填充参数到对应模板
5. 执行处理运行 FFmpeg 命令并监控进度
6. 结果验证检查输出文件并反馈处理状态
7. 优化建议根据结果提供进一步优化方案

⚠️ 关键限制、缺陷、注意事项

平台限制:

• 仅支持已安装 FFmpeg 的系统环境
• Windows 需要额外配置 Chocolatey 或手动安装

性能考量:

• 视频处理消耗大量 CPU 资源
• 大文件处理需要足够磁盘空间
• 无内置进度监控，需依赖 FFmpeg 原生输出

适用性限制:

• 适合单个或批量文件处理
• 不适合实时流媒体处理
• 无图形界面，纯命令行操作

生产环境:

• 可用于生产环境，但需要充分测试
• 建议先在测试环境验证命令效果
• 重要数据处理前务必进行备份

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景:

• 开发者需要快速获取 FFmpeg 最佳实践命令
• 多媒体内容批量处理自动化
• 社交媒体平台视频格式优化
• 教学演示中的多媒体处理示例
• 个人视频音频文件格式转换

❌ 不适合场景:

• 实时视频流处理需求
• 需要图形界面的普通用户
• 专业级视频编辑（如特效、调色等）
• 无 FFmpeg 基础的环境
• 对处理速度有极高要求的场景

skills install --user ychoi-kr/claude-ffmpeg-skill