/image-batch

name: image-batch
description: "Batch process images for marketing. Use when: resizing images for social media; compressing images for web; removing backgrounds; adding watermarks; converting formats to WebP; optimizing for Core Web Vitals"
license: MIT
metadata:
  author: ClawFu
  version: 1.0.0
  mcp-server: "@clawfu/mcp-skills"

Image Batch Processing

> Automate repetitive image tasks using Pillow and rembg - resize, compress, remove backgrounds, and watermark hundreds of images in seconds.

When to Use This Skill

• **Social media prep** - Resize images for multiple platforms at once
• **Website optimization** - Compress and convert to WebP for faster loading
• **Product photos** - Remove backgrounds, add consistent styling
• **Brand protection** - Add watermarks to marketing assets
• **Batch conversion** - Convert legacy formats to modern ones

What Claude Does vs What You Decide

| Claude Does | You Decide | |-------------|------------| | Structures video workflow | Final creative vision | | Suggests shot compositions | Equipment selection | | Creates storyboard templates | Brand aesthetics | | Generates script frameworks | Final approval | | Identifies technical requirements | Budget allocation |

Dependencies

pip install Pillow rembg click
# For GPU-accelerated background removal:
# pip install rembg[gpu]

Commands

Resize Images

python scripts/main.py resize ./images/ --width 1200
python scripts/main.py resize ./images/ --format instagram  # 1080x1080
python scripts/main.py resize ./images/ --format linkedin   # 1200x627

Compress Images

python scripts/main.py compress ./images/ --quality 80
python scripts/main.py compress ./images/ --max-size 500  # Max 500KB

Remove Background

python scripts/main.py remove-bg photo.jpg
python scripts/main.py remove-bg ./products/ --output ./transparent/

Add Watermark

python scripts/main.py watermark ./images/ --logo logo.png --position bottom-right
python scripts/main.py watermark ./images/ --text "© 2024 Company" --opacity 0.3

Convert Format

python scripts/main.py convert ./images/ --format webp
python scripts/main.py convert ./images/ --format avif --quality 80

Examples

Example 1: Prepare Product Images for E-commerce

# Remove backgrounds
python scripts/main.py remove-bg ./raw-products/ --output ./transparent/

# Resize to standard size
python scripts/main.py resize ./transparent/ --width 1000 --height 1000 --fit contain

# Compress for web
python scripts/main.py compress ./transparent/ --quality 85 --format webp

# Output: ./transparent/*.webp (optimized, transparent background)

Example 2: Social Media Image Kit

# Create multiple sizes from one source
python scripts/main.py resize hero-image.jpg --format instagram --output hero_ig.jpg
python scripts/main.py resize hero-image.jpg --format linkedin --output hero_li.jpg
python scripts/main.py resize hero-image.jpg --format twitter --output hero_tw.jpg
python scripts/main.py resize hero-image.jpg --format facebook --output hero_fb.jpg

# Or batch process entire folder for one platform
python scripts/main.py resize ./campaign-images/ --format instagram --output ./instagram/

Example 3: Website Image Optimization

# Convert all images to WebP
python scripts/main.py convert ./website-images/ --format webp --quality 80

# Ensure no image exceeds 200KB
python scripts/main.py compress ./website-images/ --max-size 200

# Results in 60-80% smaller file sizes

Social Media Format Presets

| Format | Dimensions | Aspect Ratio | Use Case | |--------|------------|--------------|----------| | `instagram` | 1080x1080 | 1:1 | Feed posts | | `instagram-story` | 1080x1920 | 9:16 | Stories/Reels | | `linkedin` | 1200x627 | 1.91:1 | Link previews | | `linkedin-post` | 1200x1200 | 1:1 | Feed posts | | `twitter` | 1200x675 | 16:9 | Cards | | `facebook` | 1200x630 | 1.91:1 | Link previews | | `pinterest` | 1000x1500 | 2:3 | Pins | | `youtube` | 1280x720 | 16:9 | Thumbnails |

Fit Modes

| Mode | Behavior | |------|----------| | `cover` | Fill area, crop excess (default) | | `contain` | Fit inside, add padding | | `stretch` | Distort to fit exactly | | `crop` | Smart crop focusing on subject |

Output Formats

| Format | Best For | Compression | |--------|----------|-------------| | `webp` | Web images | 25-35% smaller than JPEG | | `avif` | Modern browsers | 50% smaller than JPEG | | `jpg` | Photos, gradients | Lossy, universal | | `png` | Transparency, graphics | Lossless |

Skill Boundaries

What This Skill Does Well

• Structuring video production workflows
• Creating storyboard frameworks
• Suggesting technical approaches
• Providing creative direction templates

What This Skill Cannot Do

• Replace professional videography
• Edit video files directly
• Make final creative judgments
• Guarantee audience engagement

Related Skills

• [video-processing](../video-processing/) - Process video thumbnails
• [lighthouse-audit](../../seo-tools/lighthouse-audit/) - Check image impact on LCP

Skill Metadata

• **Mode**: cyborg

category: automation
subcategory: image-processing
dependencies: [Pillow, rembg]
difficulty: beginner
time_saved: 5+ hours/week