Pillow Image Processing Skill

English | 简体中文

This skill provides comprehensive image processing capabilities through executable scripts and reference documentation for Pillow (PIL).

When to Use This Skill

Activate this skill when the user requests:

• - Image editing operations (resize, crop, rotate, color adjustments)
• Batch processing multiple images
• Adding watermarks (text or image)
• Image format conversions
• Extracting image metadata or EXIF data
• Applying filters or effects
• Creating thumbnails

Core Capabilities

1. Image Editor (scripts/image_editor.py)

Edit single images with various operations:

Usage:
CODEBLOCK0

Options:

• - --width WIDTH / --height HEIGHT: Resize dimensions
• INLINECODE3: Ignore aspect ratio when resizing
• INLINECODE4: Crop rectangle
• INLINECODE5: Rotate image
• INLINECODE6: Flip image
• INLINECODE7: Adjust brightness (0.0-2.0)
• INLINECODE8: Adjust contrast (0.0-2.0)
• INLINECODE9: Adjust color saturation (0.0-2.0)
• INLINECODE10: Adjust sharpness (0.0-2.0)
• INLINECODE11: Apply filter
• INLINECODE12: Output format (JPEG, PNG, etc.)
• INLINECODE13: JPEG quality (1-100)

Examples:
CODEBLOCK1

2. Batch Processor (scripts/batch_processor.py)

Process multiple images in parallel:

Usage:
CODEBLOCK2

Options:

• - --pattern PATTERN: File pattern (e.g., *.jpg)
• INLINECODE16: Resize all images
• INLINECODE17: Create thumbnails (maintains aspect)
• INLINECODE18: Convert to grayscale
• INLINECODE19: Adjust brightness
• INLINECODE20: Convert format
• INLINECODE21: JPEG quality
• INLINECODE22: Number of parallel workers (default: 4)

Examples:
CODEBLOCK3

3. Watermark Tool (scripts/watermark.py)

Add text or image watermarks:

Usage:
CODEBLOCK4

Common Options:

• - --position {top-left,top-right,bottom-left,bottom-right,center}: Position
• INLINECODE25: Transparency level
• INLINECODE26: Margin from edge

Text Options:

• - --font-size SIZE: Font size
• INLINECODE28: Text color (white/black/red/etc)

Image Options:

• - --scale RATIO: Watermark scale (0.0-1.0)

Examples:
CODEBLOCK5

4. Image Info (scripts/image_info.py)

Extract image metadata and properties:

Usage:
CODEBLOCK6

Options:

• - --format {text,json}: Output format
• INLINECODE32: Save to file

Provides:

• - File information (size, path)
• Image properties (dimensions, format, mode)
• Color information (bands, palette)
• EXIF data (if available)
• Metadata

Example:
CODEBLOCK7

Reference Documentation

references/common_operations.md

Comprehensive Pillow reference covering:

• - Opening and saving images
• Resizing and cropping
• Rotation and flipping
• Color adjustments and enhancements
• Filters and effects
• Drawing on images
• Image composition
• Working with channels
• EXIF data handling
• Performance tips

When to use: When Claude needs specific Pillow syntax or operation patterns.

references/best_practices.md

Best practices guide covering:

• - Format selection (JPEG vs PNG vs WebP)
• Resizing strategies
• Color mode conversion
• Memory management
• Watermarking strategies
• Filter application
• Optimization techniques
• Error handling patterns
• Common workflows

When to use: When designing image processing workflows or optimizing performance.

Workflow Guidelines

Step 1: Analyze Requirements

• - What format is the input image?
• What operations are needed?
• Is it a single image or batch?
• Are there quality requirements?

Step 2: Choose the Right Tool

• - Single image edit → INLINECODE35
• Multiple images → INLINECODE36
• Add watermark → INLINECODE37
• Need info → INLINECODE38

Step 3: Plan Operations

• - Apply operations in logical order
• Consider quality vs file size tradeoffs
• Validate input requirements

Step 4: Execute and Validate

• - Run the script with appropriate options
• Check output quality
• Verify file sizes and formats

Common Patterns

Pattern 1: Web Image Optimization

Pattern 2: Create Image Gallery

Pattern 3: Brand Images with Watermark

Pattern 4: Batch Format Conversion

Dependencies

CODEBLOCK12

Tips for Effective Use

1. 1. Preserve originals: Never overwrite source images
2. Use appropriate formats: JPEG for photos, PNG for graphics
3. Optimize quality: Balance quality and file size
4. Batch operations: Use batch processor for multiple images
5. Check references: Consult reference docs for advanced operations
6. Validate inputs: Check image format and size before processing
7. Test first: Try operations on one image before batch processing

Limitations

• - Limited to 2D image processing (no video)
• Some EXIF data may not be preserved in all formats
• Font availability may vary by system
• Very large images may require significant memory
• Advanced photo editing (layers, masks) requires specialized tools

Troubleshooting

Import errors: Ensure Pillow is installed (pip install Pillow)
Font not found: Watermark script falls back to default font
Memory errors: Process large images in smaller batches
Format errors: Check input image format compatibility
RGBA to JPEG: Script automatically handles RGBA→RGB conversion

For detailed operations and troubleshooting, always refer to references/common_operations.md and references/best_practices.md.