| name | image-processing |
| description | Process images for web development - resize, crop, trim whitespace, convert formats (PNG/WebP/JPG), optimise file size, generate thumbnails, create OG card images. Uses Pillow (Python) - no ImageMagick needed. Trigger with 'resize image', 'convert to webp', 'trim logo', 'optimise images', 'make thumbnail', 'create OG image', 'crop whitespace', 'process image', or 'image too large'. |
| compatibility | claude-code-only |
Image Processing
Process images for web development. Generate a Pillow script adapted to the user's environment and specific needs.
Prerequisites
Pillow is usually pre-installed. If not:
pip install Pillow
If Pillow is unavailable, adapt using alternatives:
| Alternative | Platform | Install | Capabilities |
|---|
sips | macOS (built-in) | None | Resize, convert (no trim/OG) |
sharp | Node.js | npm install sharp | Full feature set |
ffmpeg | Cross-platform | brew install ffmpeg | Resize, convert |
Capabilities
Generate a Python script using Pillow for any of these operations. See references/pillow-patterns.md for implementation patterns, especially RGBA-to-JPG compositing and cross-platform font discovery.
Resize
Scale to specific dimensions or by width/height (maintain aspect ratio if only one given). Use Image.LANCZOS for high-quality downscaling.
Convert Format
Convert between PNG, JPG, WebP. Handle RGBA-to-JPG by compositing onto white background. Apply format-specific quality settings (WebP: 85, JPG: 90, PNG: optimize).
Trim Whitespace
Auto-crop surrounding whitespace from logos and icons. Convert to RGBA first, then use getbbox() to find content bounds.
Thumbnail
Fit within max dimensions while maintaining aspect ratio. Use img.thumbnail((size, size), Image.LANCZOS).
Optimise for Web
Resize + compress in one step. Convert to WebP for best compression. Typical settings: width 1920, quality 85.
OG Card (1200x630)
Generate Open Graph card with title/subtitle overlay on a background image or solid colour. Apply semi-transparent overlay for text readability. Centre text horizontally.
Common Workflows
Logo Cleanup (client-supplied JPG with white background)
- Trim whitespace
- Convert to PNG (for transparency)
- Create favicon-sized version (thumbnail at 512px)
Prepare Hero Image for Production
Resize to max width 1920, convert to WebP, compress at quality 85.
Batch Process
For multiple images, generate a single script that loops over all files rather than processing one at a time.
Pipeline with Gemini Image Gen
Generate images with the gemini-image-gen skill, then process them:
- Generate with Gemini (raw PNG output)
- User picks favourite
- Optimise: resize to target width, convert to WebP, compress
Output Format Guide
| Use case | Format | Why |
|---|
| Photos, hero images | WebP | Best compression, wide browser support |
| Logos, icons (need transparency) | PNG | Lossless, supports alpha |
| Fallback for older browsers | JPG | Universal support |
| Thumbnails | WebP or JPG | Small file size priority |
| OG cards | PNG | Social platforms handle PNG best |
Reference Files
