---

name: image-processing description: Smart image processing for resize, compress, and convert operations with batch support. Use when users ask to resize images, compress photos, convert to WebP/AVIF, batch process images, optimize for social media, or create image thumbnails. Supports modern formats and aspect ratios.

Image Processing

Smart image processor with automatic single-file and batch operation detection, modern format support, and social media presets.

Quick Start

Process images with optimal defaults:

Copycd ~/.claude/scripts/media-tools
bun run image photo.jpg --Format webp --Quality 85

Intelligent Behavior

Automatically detects input type and adjusts processing:

CLI Options

Features

Format Support:

• WebP - Best compression/quality ratio (recommended)
• AVIF - Next-gen format, excellent compression
• JPG - Universal compatibility
• PNG - Lossless, supports transparency

Smart Processing:

• Preserves original files (creates new output)
• Strips metadata for smaller files
• Maintains aspect ratio or crops to specified ratio
• Handles batch operations efficiently

Supported Input Formats: jpg, jpeg, png, gif, webp, tiff, avif, bmp, heic

Usage Examples

Single file - resize and convert

Copybun run image photo.jpg --Resolution 1920 --Ratio 16:9 --Format webp

Single file - compress only

Copybun run image photo.jpg --Format webp --Quality 75

Batch - entire folder

Copybun run image ./photos/ --Resolution 1280 --Format webp --Output subfolder

Shows preview before processing:

CopyFound 24 images to process:
- photo1.jpg (2.4 MB)
- photo2.png (1.8 MB)
- ... and 22 more

Settings:
- Resolution: 1280 (original → 1280px width)
- Ratio: original (keep aspect ratio)
- Format: webp
- Quality: 85%
- Output: ./photos/processed/

Proceed? [Yes/No]

Batch - specific files

Copybun run image "*.png" --Format webp --Quality 85

Instagram post (1:1 ratio)

Copybun run image ./uploads/ --Resolution 1280 --Ratio 1:1 --Format jpg

Instagram story (9:16 ratio)

Copybun run image ./content/ --Resolution 1080 --Ratio 9:16 --Format jpg --Quality 90

Social Media Presets

Processing Modes

With resize and crop (when ratio specified)

Copymagick input.jpg \
  -resize 1920x1080^ \
  -gravity center \
  -extent 1920x1080 \
  -quality 85 \
  -strip \
  output.webp

Compress only (original dimensions)

Copymagick input.jpg \
  -quality 85 \
  -strip \
  output.webp

Resize without crop (original ratio)

Copymagick input.jpg \
  -resize 1920x \
  -quality 85 \
  -strip \
  output.webp

Aspect Ratio Calculations

When a ratio is specified, height is calculated automatically:

Processing Results

After batch processing, shows detailed report:

Copy✓ Processed 24 images

Summary:
- Total input:  45.2 MB
- Total output: 12.8 MB
- Compression:  72% smaller
- Time:         1.2s

Output: ./processed/

Best Practices

1. Use WebP for web - 30% smaller than JPG with same quality
2. Keep originals - Tool never modifies source files
3. Quality 85 - Sweet spot for most use cases
4. Add dimensions - Prevent layout shifts on web
5. Test compression - Start with Quality 85, adjust if needed
6. Batch wisely - Process similar images together
7. Use ratios for social - Consistent sizing across platforms

Requirements

• ImageMagick 7+ - Uses magick command
• Install: brew install imagemagick

Related Files

• Command: plugins/media-tools/commands/image.md
• Media Processor: plugins/media-tools/skills/media-processor/
• Video Processing: plugins/media-tools/skills/video-processing/