Image Processing

What it does

This skill enables AI agents to perform a variety of image processing tasks using Python and the Pillow library. It supports resizing, cropping, format conversion (PNG, WebP, JPG), compression, thumbnail generation, and Open Graph card creation. If Pillow is unavailable, it falls back to alternative tools like sips (macOS), sharp (Node.js), or ffmpeg.

When to use it

• To resize images for website hero sections (e.g., "resize hero.png --width 1920").
• When converting image formats, such as changing a PNG logo to WebP ("convert logo.png --format webp").
• For optimizing images by reducing file size while maintaining quality ("optimise hero.jpg --quality 85 --max-width 1920").
• To generate Open Graph cards for social media sharing ("og-card -o og.png --title "My App" --subtitle "Built for speed"").
• For batch processing a directory of images into a different format ("batch ./images --action convert --format webp -o ./optimised").

Key capabilities

• Image Resizing: Adjusts image dimensions.
• Format Conversion: Converts between PNG, WebP, and JPG formats.
• Optimization: Compresses images for smaller file sizes.
• Thumbnail Generation: Creates smaller versions of images.
• Open Graph Card Creation: Generates images with title and subtitle for social sharing.
• Batch Processing: Applies operations to multiple images at once.
• Fallback Options: Uses sips, sharp, or ffmpeg if Pillow is not installed.

Example prompts

• "Resize this image to a width of 1920 pixels."
• "Convert this PNG logo to WebP format."
• "Create an Open Graph card for my app with the title 'My App' and subtitle 'Built for speed'."
• "Optimize all images in this folder, limiting their maximum width to 1920 pixels."

Tips & gotchas

• Prerequisites: Pillow is required for full functionality. Install it using pip install Pillow.
• img-process vs. Custom Scripts: Use the img-process command line tool for standard operations. For more complex tasks (compositing, watermarks), generate a custom Python script.
• Format-Specific Quality Settings: WebP images use a quality setting of 85, JPG uses 90, and PNG is optimized by default.