/install mp4-to-gif
MP4 to GIF Conversion
Overview
Convert MP4 videos to high-quality GIFs using ffmpeg's two-pass palette method. The two-pass approach produces significantly better color quality than direct conversion.
When to Use
- User wants to convert MP4 (or other video) to GIF
- User needs to create GIFs from video for documentation, demos, or sharing
- User asks about reducing GIF file size or improving GIF quality
Prerequisites
- ffmpeg must be installed and available in PATH
Core Method
Two-pass palette-based conversion (always use this over single-pass):
# Pass 1: Generate optimized palette
ffmpeg -y -i \x3Cinput> -vf "fps=15,scale=480:-1:flags=lanczos,palettegen=stats_mode=diff" /tmp/palette.png
# Pass 2: Convert using palette
ffmpeg -y -i \x3Cinput> -i /tmp/palette.png -lavfi "fps=15,scale=480:-1:flags=lanczos [x]; [x][1:v] paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle" \x3Coutput>
Quick Reference
| Parameter | Default | Effect |
|---|---|---|
fps |
15 | Frame rate — lower = smaller file, choppier motion |
scale width |
480 | Output width in px — height auto-calculated (-1) |
lanczos |
— | High-quality downscaling filter |
stats_mode=diff |
— | Palette optimized for frame differences (better for motion) |
dither=bayer |
— | Ordered dithering, good balance of quality/size |
bayer_scale |
5 | Dither strength (0-5), higher = more dithering |
diff_mode=rectangle |
— | Only update changed regions (smaller file) |
Size vs Quality Tradeoffs
| Goal | Adjust |
|---|---|
| Smaller file | Lower fps (10), smaller width (320), or trim duration |
| Smoother motion | Higher fps (24-30), but file size increases significantly |
| Better colors | Use stats_mode=full for static/slow content |
| Sharper | Increase width (640-800), costs more file size |
Bundled Scripts
Two scripts are bundled alongside this SKILL.md. Use the one matching the current platform.
Windows (PowerShell) — mp4_to_gif.ps1:
& "\x3Cthis-skill-dir>/mp4_to_gif.ps1" -InputFile \x3Cinput> # Defaults: 480px, 15fps
& "\x3Cthis-skill-dir>/mp4_to_gif.ps1" -InputFile \x3Cinput> -Width 640 -Fps 20 # Custom settings
& "\x3Cthis-skill-dir>/mp4_to_gif.ps1" -InputFile \x3Cinput> -OutputFile \x3Coutput> # Custom output name
Linux / macOS (Bash) — mp4_to_gif.sh:
bash "\x3Cthis-skill-dir>/mp4_to_gif.sh" -i \x3Cinput> # Defaults: 480px, 15fps
bash "\x3Cthis-skill-dir>/mp4_to_gif.sh" -i \x3Cinput> -w 640 -f 20 # Custom settings
bash "\x3Cthis-skill-dir>/mp4_to_gif.sh" -i \x3Cinput> -o \x3Coutput> # Custom output name
When Claude invokes this skill, resolve \x3Cthis-skill-dir> to the absolute path of the directory containing this SKILL.md.
Common Mistakes
- Single-pass conversion (
ffmpeg -i in.mp4 out.gif) — produces terrible banding and color artifacts. Always use the two-pass palette method. - Too high fps — 30fps GIFs are massive. 15fps is usually sufficient for demos.
- Too wide — 480px is good for most uses. Full 1080p GIFs are impractically large.
- Forgetting to clean up palette — Delete the temporary palette.png after conversion.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install mp4-to-gif - 安装完成后,直接呼叫该 Skill 的名称或使用
/mp4-to-gif触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Mp4 To Gif 是什么?
Use when the user wants to convert MP4 video files to GIF format, or asks about video-to-GIF conversion with quality/size control. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 68 次。
如何安装 Mp4 To Gif?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install mp4-to-gif」即可一键安装,无需额外配置。
Mp4 To Gif 是免费的吗?
是的,Mp4 To Gif 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Mp4 To Gif 支持哪些平台?
Mp4 To Gif 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Mp4 To Gif?
由 ZZLupus(@zzlupus)开发并维护,当前版本 v1.0.0。