video-to-gif — Claude Code skill: video into GIF variants
Turns one video into several GIFs at different settings and drops them in a folder, so you pick the one that looks right.
npx skills add zc277584121/marketing-skills --skill video-to-gif -a claude-codeWhat video-to-gif does
The skill runs a video file through a sweep of parameters: frame rate, width, colour count. You get a <input>_gifs/ directory with the variants plus a sorted table listing file size, FPS, width and colours. No guessing about settings — the comparison is right there.
The default full preset produces 18 variants: 3 FPS values (10, 15, 20), 3 widths (480, 640, 800) and 2 colour counts (128, 256). Other presets are minimal, lossy and quality. Trim the clip with --start and --end, or override the sweep yourself with --fps, --width, --colors, --lossy.
FFmpeg and uv have to be installed first, otherwise the script will not run. gifsicle matters only for lossy variants — skip it and the lossy preset has nothing to work with. Widths above the source resolution get skipped automatically. The palette is built in two passes, which beats a single-pass build on quality. Trim long clips up front, because a GIF past 10 seconds gets heavy. For screen recordings, a sensible starting point is 640px, 15fps, 256 colours.
What it helps with
- turn a clip into a GIF without hand-tuning parameters
- compare file size against quality across several variants
- cut a specific time range out of a video
- get a small GIF for a chat message or docs page
- spot colour banding when the palette is too small
Example prompts for the agent
- make a GIF from demo.mp4, just the first 10 seconds
- run demo.mp4 with the minimal preset, I want a quick comparison
- generate variants from demo.mp4 with fps 12 and 15 and width 480 and 800
How to install video-to-gif
1Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill video-to-gif -a claude-code2Manually: put the files in place
~/.claude/skills/video-to-gif/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/video-to-gif/
1Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill video-to-gif -a codex2Manually: put the files in place
.agents/skills/video-to-gif/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill video-to-gif -a cursor2Manually: put the files in place
.cursor/skills/video-to-gif/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install zc277584121/marketing-skills video-to-gif2Manually: put the files in place
.github/skills/video-to-gif/SKILL.md1Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill video-to-gif -a gemini-cli2Platform CLI
gemini skills install https://github.com/zc277584121/marketing-skills --path skills/video-to-gifManually: put the files in place
.devin/skills/video-to-gif/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill video-to-gif -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about video-to-gif
How do I install video-to-gif in Claude?
Run npx skills add zc277584121/marketing-skills --skill video-to-gif -a claude-code. The skill lands at ~/.claude/skills/video-to-gif/SKILL.md.
What does video-to-gif do?
It converts a video into a set of GIFs at different FPS, widths and colour counts, then prints a table of file sizes so you can pick one.
What do I need for video-to-gif to work?
FFmpeg and uv are required. Install gifsicle if you want the lossy compression variants.
