Skip to content
video-to-gif logo

Skill: Video to GIF

video-to-gif

Convert a video to multiple GIF variants with different quality/size tradeoffs. Generates a comparison set so the user can visually pick the best result.

SKILL.md

Full skill instructions

Skill: Video to GIF

Convert a video file into multiple GIF variants with different parameters, so the user can visually compare and pick the best one.

Prerequisite: FFmpeg and uv must be installed. gifsicle is optional (enables lossy compression variants).


When to Use

The user wants to create a GIF from a video clip but isn't sure about the right parameters. GIF quality involves tradeoffs between:

  • File size — smaller is better for sharing/​embedding
  • Color accuracy — fewer colors = smaller but may cause banding
  • Smoothness — higher FPS = smoother but larger
  • Resolution — wider = sharper detail but larger

Rather than guessing, this skill generates multiple variants and lets the user decide.


Default Workflow

When the user provides a video file:

uv run --python 3.12 /​path/​to/​skills/​video-to-gif/​scripts/​video_to_gif.py <input.mp4>

This generates GIFs in <input>_gifs/ directory with the full preset (18 variants):

  • 3 FPS options: 10, 15, 20
  • 3 widths: 480px, 640px, 800px
  • 2 color counts: 128, 256

Output includes a sorted comparison table showing file size, FPS, width, and colors for each variant.


Presets

PresetVariantsBest For
full~18General use — broad exploration of the parameter space
minimal~4Quick comparison — just a few key tradeoff points
lossy~12Smallest files — includes gifsicle lossy compression levels
quality~12Best visuals — higher res, includes bayer dithering
# Quick comparison with fewer variants
uv run --python 3.12 .../​video_to_gif.py input.mp4 --presets minimal

# Include lossy compression (requires gifsicle)
uv run --python 3.12 .../​video_to_gif.py input.mp4 --presets lossy

# Higher quality focus
uv run --python 3.12 .../​video_to_gif.py input.mp4 --presets quality

Common Options

FlagDefaultDescription
-o, --output-dir<input>_gifs/Output directory for all GIF variants
--startnoneStart time in seconds (trim source)
--endnoneEnd time in seconds (trim source)
--presetsfullPreset config: full, minimal, lossy, quality
--fpspresetOverride FPS values (e.g., --fps 10 15 20)
--widthpresetOverride width values (e.g., --width 480 640)
--colorspresetOverride color counts (e.g., --colors 128 256)
--lossypresetGifsicle lossy levels (e.g., --lossy 0 30 80)

Examples

# Convert first 10 seconds of a video
uv run --python 3.12 .../​video_to_gif.py demo.mp4 --end 10

# Extract a specific segment
uv run --python 3.12 .../​video_to_gif.py demo.mp4 --start 5 --end 15

# Custom parameter sweep
uv run --python 3.12 .../​video_to_gif.py demo.mp4 --fps 12 15 --width 480 800 --colors 256

# Lossy compression comparison (needs gifsicle)
uv run --python 3.12 .../​video_to_gif.py demo.mp4 --lossy 0 30 60 100

How to Choose

After running, open the output directory and compare:

  1. Start with the smallest files — check if quality is acceptable
  2. Look for color banding — if visible, try 256 colors or bayer dithering (quality preset)
  3. Check smoothness — if too choppy, go up to 15 or 20 FPS
  4. Check clarity — if text is unreadable, go up to 640 or 800px width

The sweet spot for most screen recordings is usually around 640px, 15fps, 256 colors.


Important Notes

  • Widths larger than the source video resolution are automatically skipped.
  • The script uses FFmpeg's two-pass palette generation for optimal GIF quality (much better than single-pass).
  • Lossy compression via gifsicle can reduce file size by 30-70% with minimal visual impact at level 30-60.
  • For very long clips, consider trimming with --start/--end first — GIFs over 10 seconds can get very large.

More Marketing & SEO skills

copywriting logo
Marketing & SEO

copywriting

Marketing copy for homepages, landing pages, pricing pages, and other conversion-focused web pages.

53.3K 216.1K
View
flux-2-klein logo
Marketing & SEO

flux-2-klein

Fast image generation with Flux 2 Klein, optimized for sub-second iteration and multi-reference brand styling.

52 176.2K
View
marketing-psychology logo
Marketing & SEO

marketing-psychology

Psychological principles and mental models for understanding customer behavior and influencing marketing decisions.

53.3K 153K
View
content-strategy logo
Marketing & SEO

content-strategy

Plan searchable and shareable content that drives traffic, builds authority, and generates leads.

53.3K 150.9K
View
programmatic-seo logo
Marketing & SEO

programmatic-seo

Build SEO-optimized pages at scale using templates, data, and proven playbook patterns.

53.3K 140.1K
View
marketing-ideas logo
Marketing & SEO

marketing-ideas

Brainstorm and prioritize marketing strategies tailored to your SaaS stage, budget, and goals.

53.3K 137.2K
View
ai-seo logo
Marketing & SEO

ai-seo

Optimize content for discovery, citation, and visibility across AI search platforms and LLM assistants.

53.3K 136.7K
View
copy-editing logo
Marketing & SEO

copy-editing

Systematic improvement of existing marketing copy through seven focused editing passes.

53.3K 136.4K
View
site-architecture logo
Marketing & SEO

site-architecture

Plan and optimize your website's page hierarchy, navigation, URL structure, and internal linking.

53.3K 112.8K
View
revops logo
Marketing & SEO

revops

Design and optimize systems connecting marketing, sales, and customer success into a unified revenue engine.

53.3K 104.9K
View
brand-guidelines logo
Marketing & SEO

brand-guidelines

Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.

179.7K 100.1K
View
website-to-hyperframes logo
Marketing & SEO

website-to-hyperframes

Convert websites into professional HyperFrames videos with guided storyboarding and brand-aligned composition.

57K 93.5K
View

Sales & marketing AI tools

KreadoAI logo
Sales & marketing

KreadoAI

Revolutionize Video Creation with AI-Generated Avatars and Voices

Paid
View
Followr logo
Sales & marketing

Followr

Social media on autopilot

Paid
View
Logodiffusion logo
Sales & marketing

Logodiffusion

Design custom logos instantly with AI.

Paid
View
I
Sales & marketing

Ideogram

Text-heavy marketing and design images

Freemium
View
Prompt Silo logo
Sales & marketing

Prompt Silo

Boost Your SEO with Content and SEO Silos

Free
View
Marketing Blocks logo
Sales & marketing

Marketing Blocks

Revolutionize Your Marketing with AI-Powered MarketingBlocks!

Paid
View
Scrip AI logo
Sales & marketing

Scrip AI

10X faster & free AI content creation for 100+ use cases

Free
View
Tribescaler logo
Sales & marketing

Tribescaler

Tribescaler | Make Your Tweets Go Viral

Paid
View