| name | manipulate-image |
| description | Manipulate images - resize, crop, convert, add alpha, transform, compress, and analyze. Use when user needs any image manipulation, format conversion, or image information. |
| argument-hint | [operation] [image path] [options] |
| allowed-tools | Bash, Read, Write, Glob, AskUserQuestion |
Image Tools
Swiss army knife for image manipulation powered by Pillow.
First Use
Run setup check:
bash "${CLAUDE_PLUGIN_ROOT}/skills/manipulate-image/scripts/check-setup.sh"
If it fails, read the install guide:
${CLAUDE_PLUGIN_ROOT}/skills/manipulate-image/scripts/install.md
Running Commands
SCRIPTS="${CLAUDE_PLUGIN_ROOT}/skills/manipulate-image/scripts"
"$SCRIPTS/run.sh" <command> [args...]
Available Commands
Workflow
- Run
check-setup.sh if this is the first use or you hit errors
- Read the instruction file for the operation the user needs
- Run
run.sh <command> with the right arguments
- Show the user the result
Transparent Background from AI-Generated Images
When removing backgrounds from images generated by image-tools:generate-image (or similar AI tools):
-
Sample the actual background color (AI never produces exact colors):
-
Remove with --feather (activates HSV chroma key + spill suppression):
run.sh alpha <image> --transparent "<actual R,G,B>" --tolerance 15 --feather 40 -o <output>
run.sh trim <output> -o <final>
Chroma key palette (the generate-image skill picks the best one based on subject colors):
| Color | Exact RGB | Hex | Approximate AI output |
|---|
| Green | 0, 255, 0 | #00FF00 | varies around (0-20, 240-255, 0-20) |
| Magenta | 255, 0, 255 | #FF00FF | varies around (235-255, 0-20, 235-255) |
| Blue | 0, 0, 255 | #0000FF | varies around (0-20, 0-20, 235-255) |
| Yellow | 255, 255, 0 | #FFFF00 | varies around (235-255, 235-255, 0-20) |
Always sample the actual corner pixel — Gemini never produces the exact requested RGB.
Why --feather matters: Without it, you get binary transparency with colored halos. With it, the algorithm uses HSV hue detection (handles imprecise colors), Gaussian-blurred alpha edges, and spill suppression that removes background color contamination from outline pixels.
See the image-tools:generate-image skill for chroma key color selection rules.
Quick Reference
All commands accept: input (file or directory for batch), -o/--output.