video-to-gif

# Video to GIF / 视频转 GIF ## Purpose / 功能定位 ### English Use this skill when the task is to convert a video file into a GIF animation. This skill is intended for requests such as: - convert a video to GIF - make a GIF from a clip - export part of a video as a GIF - create a smaller GIF by limiting width, frame rate, or duration ### 中文 当任务是把一个视频文件转换成 GIF 动图时，应使用这个 Skills。 这个 Skills 适合处理以下类型的请求： - 把视频转成 GIF - 从视频里截取一段做成 GIF - 导出视频片段为 GIF - 通过限制宽度、帧率、时长来生成更小的 GIF ## What This Skill Does / 这个 Skills 做什么 ### English This skill uses `ffmpeg` to convert video into GIF and supports: - custom frame rate - custom output width - custom start time - custom duration - output file summary after conversion ### 中文 这个 Skills 使用 `ffmpeg` 将视频转换为 GIF，并支持： - 自定义帧率 - 自定义输出宽度 - 自定义开始时间 - 自定义截取时长 - 转换完成后输出结果摘要 ## Prerequisites / 前置依赖 ### English This skill requires: - `ffmpeg` - `ffprobe` Before running the script, check: ```bash command -v ffmpeg command -v ffprobe ``` If either command is missing, ask the user to install ffmpeg first instead of trying to auto-install it silently. ### 中文 这个 Skills 依赖： - `ffmpeg` - `ffprobe` 运行脚本前先检查： ```bash command -v ffmpeg command -v ffprobe ``` 如果缺少其中任意一个命令，应先提示用户安装 `ffmpeg`，而不是静默自动安装。 ## Quick Start / 快速开始 ### English ```bash python3 scripts/convert.py input.mp4 output.gif python3 scripts/convert.py input.mp4 output.gif --fps 12 --width 360 python3 scripts/convert.py input.mp4 output.gif --start 00:00:03 --duration 5 ``` ### 中文 ```bash python3 scripts/convert.py input.mp4 output.gif python3 scripts/convert.py input.mp4 output.gif --fps 12 --width 360 python3 scripts/convert.py input.mp4 output.gif --start 00:00:03 --duration 5 ``` ## Parameters / 参数 | Parameter / 参数 | Type / 类型 | Required / 必填 | Default / 默认值 | Description / 说明 | |---|---|---|---|---| | `input` | string | yes | - | input video path / 输入视频路径 | | `output` | string | yes | - | output GIF path / 输出 GIF 路径 | | `fps` | number | no | 15 | output frame rate / 输出帧率 | | `width` | number | no | 480 | output width in pixels / 输出宽度像素 | | `start` | string | no | `0` | clip start time / 开始时间 | | `duration` | string | no | - | clip duration / 持续时间 | ## Workflow / 工作流程 ### English 1. Confirm the input file exists. 2. Confirm `ffmpeg` and `ffprobe` are installed. 3. Choose optional parameters such as `fps`, `width`, `start`, and `duration`. 4. Run the conversion script. 5. Return the output path, size, dimensions, and frame rate. ### 中文 1. 确认输入文件存在。 2. 确认 `ffmpeg` 和 `ffprobe` 已安装。 3. 选择需要的可选参数，例如 `fps`、`width`、`start`、`duration`。 4. 执行转换脚本。 5. 返回输出路径、文件大小、尺寸和帧率。 ## When To Use / 适用场景 ### English Use this skill when the user wants a GIF generated from a local video file. ### 中文 当用户希望从本地视频文件生成 GIF 时，应使用这个 Skills。 ## When Not To Use / 不适用场景 ### English Do not use this skill for: - editing video timelines in a full editor - downloading online videos - generating animated stickers in platform-specific formats - converting images into GIF slideshows ### 中文 以下场景不应使用这个 Skills： - 完整的视频时间线编辑 - 下载在线视频 - 生成特定平台格式的动态贴纸 - 把多张图片拼接成 GIF 轮播 ## Script / 脚本 ### English Use: ```bash python3 scripts/convert.py <input> <output> [--fps N] [--width N] [--start T] [--duration T] ``` ### 中文 使用方式： ```bash python3 scripts/convert.py <input> <output> [--fps N] [--width N] [--start T] [--duration T] ```