/claude-gif

name: claude-gif
description: >
  Ultimate GIF creator: AI video-to-GIF (Veo 3.1), programmatic animations (Remotion),
  AI image sequence assembly (Gemini/FLUX.2), animated SVG-to-transparent-GIF (Playwright),
  video conversion, and GIF editing/optimization. Palette optimization, perfect loops,
  platform-specific sizing, dithering control. Use when user says "gif", "create gif",
  "make gif", "animated gif", "convert to gif", "optimize gif", "gif from video",
  "meme gif", "reaction gif", "loading spinner gif", "logo animation gif",
  "transparent gif", "svg to gif", or "/gif".
argument-hint: "[create|generate|convert|optimize|edit] <idea, path, or command>"
allowed-tools:
  - Bash
  - Read
  - Write
  - Edit
  - Glob
  - Grep
metadata:
  version: "1.0.0"
  author: AgriciDaniel

claude-gif -- The Ultimate GIF Creator

Orchestrates five sub-skills to create, generate, convert, optimize, and edit GIFs. Every path from concept to final optimized GIF runs through this skill.

Quick Reference

| Command | Description | Sub-Skill | |---------|-------------|-----------| | `/gif create <idea>` | Programmatic animation via Remotion (text, spinners, memes, motion graphics) | claude-gif-create | | `/gif generate <prompt>` | AI video generation via Veo 3.1, then convert to GIF | claude-gif-generate | | `/gif convert <path>` | Convert video, image sequence, or animated SVG to GIF | claude-gif-convert | | `/gif optimize <path>` | Reduce GIF file size for a target platform | claude-gif-optimize | | `/gif edit <path>` | Modify an existing GIF (speed, reverse, crop, text, trim) | claude-gif-edit | | `/gif setup` | Install/verify all dependencies | (setup.sh) | | `/gif <idea>` | Auto-detect best approach from description | (orchestrator routes) |

Orchestration Logic

When the user invokes `/gif`, determine intent and route to the correct sub-skill.

Intent Detection

1. **Has a file path to a video/image/SVG?** --> `/gif convert` 2. **Has a file path to an existing GIF?**

• Mentions size, compress, platform fit --> `/gif optimize`
• Mentions speed, reverse, crop, text, trim --> `/gif edit`

3. **Describes a text animation, spinner, counter, meme, logo animation, progress bar?** --> `/gif create` 4. **Describes realistic/cinematic motion, product demo, abstract art, nature scene?** --> `/gif generate` 5. **Ambiguous description of something to animate?**

• If it involves text, geometric shapes, UI elements --> `/gif create` (Remotion)
• If it involves photorealistic subjects, complex motion --> `/gif generate` (Veo)

6. **Mentions "optimize", "compress", "reduce", "fit", platform name?** --> `/gif optimize` 7. **Mentions "edit", "speed", "reverse", "crop", "text overlay"?** --> `/gif edit` 8. **Says "setup" or "install"?** --> Run `bash ~/.claude/skills/claude-gif/scripts/setup.sh`

Routing Commands

/gif create "bouncing hello world text"      --> claude-gif-create
/gif generate "campfire flickering at night"  --> claude-gif-generate
/gif convert ~/Videos/clip.mp4               --> claude-gif-convert
/gif convert ~/Design/logo.svg               --> claude-gif-convert (Mode D: SVG)
/gif optimize ~/Documents/gif_output/big.gif --> claude-gif-optimize
/gif edit ~/Documents/gif_output/clip.gif    --> claude-gif-edit
/gif setup                                   --> scripts/setup.sh

Bare `/gif <description>` Routing

When no explicit sub-command is given, analyze the description:

• Keywords "text", "spinner", "loading", "counter", "meme", "typewriter", "logo reveal", "progress" --> create
• Keywords "realistic", "cinematic", "product", "nature", "abstract", "person", "animal" --> generate
• A file path to .mp4/.webm/.mov/.avi/.mkv/.svg --> convert
• A file path to .gif + size/platform keywords --> optimize
• A file path to .gif + edit keywords --> edit

Quality Presets

| Preset | Width | FPS | Colors | Dither | Max Size | Best For | |--------|-------|-----|--------|--------|----------|----------| | `discord` | 320px | 10 | 128 | bayer:3 | 256 KB | Discord inline embeds | | `slack` | 400px | 12 | 192 | floyd_steinberg | 500 KB | Slack messages | | `twitter` | 480px | 15 | 256 | floyd_steinberg | 15 MB | Twitter/X posts | | `web` | 480px | 15 | 256 | floyd_steinberg | 2 MB | General web usage | | `hq` | 640px | 20 | 256 | sierra2 | 10 MB | High-quality display |

Safety Rules

1. **No-overwrite**: Always pass `-n` to FFmpeg (skip if output exists). Only pass `-y` when user explicitly says overwrite. 2. **Source protection**: NEVER write output to the same path as input. Preflight catches this. 3. **Cost confirmation**: Veo generation costs money. Always confirm with user before calling generate.py. 4. **Temp isolation**: All intermediate files go in `/tmp/claude-gif/`. Clean up on completion. 5. **Output directory**: Final GIFs go to `~/Documents/gif_output/` unless user specifies a different path. 6. **Preflight check**: Run `bash ~/.claude/skills/claude-gif/scripts/preflight.sh <input> <output>` before any file write.

Multi-Step Pipelines

Complex requests may chain sub-skills:

generate --> convert --> optimize
  (Veo)    (to GIF)   (for Discord)

create --> optimize
(Remotion)  (shrink)

convert --> edit --> optimize
(video)   (trim)   (platform)

convert (SVG) --> optimize
  (Playwright)    (for web)

Always plan the full pipeline before starting. Tell the user the steps.

Pre-Flight

Before ANY write operation:

bash ~/.claude/skills/claude-gif/scripts/preflight.sh <input_file> <output_file>

On `/gif setup` or first use:

bash ~/.claude/skills/claude-gif/scripts/check_deps.sh

If dependencies are missing:

bash ~/.claude/skills/claude-gif/scripts/setup.sh

Reference Files

Load on demand -- only read the reference relevant to the current task:

| Reference | Path | When to Load | |-----------|------|-------------| | GIF Optimization | `~/.claude/skills/claude-gif/references/gif-optimization.md` | Be