image-to-webp - SKILL.md Agent Skill

name: image-to-webp description: Download images from URLs, resize them, and convert to WebP format. Use when downloading stock images from sites like Pexels for local caching. allowed-tools: - Bash(python:*) disable-model-invocation: false

Image to WebP Conversion Skill

Download images from URLs (like Pexels), resize them to 800x600 by default, and convert to WebP format for storage in the project's public/ folder.

Usage

Run the conversion script with one or more image URLs:

python .claude/skills/image-to-webp/scripts/convert.py <url> [url2] [url3] [options]

Parameters

Parameter	Description	Default
`urls`	One or more image URLs to download	Required
`--output`	Output filename prefix (without extension)	Auto-generated from URL
`--width`	Target width in pixels	800
`--height`	Target height in pixels	600
`--quality`	WebP quality 1-100	85
`--dest`	Destination folder	`./public`
`--keep-ratio`	Maintain aspect ratio (fit within dimensions)	Off (crops to fill)

Examples

Basic usage - download, resize to 800x600, convert to WebP

python .claude/skills/image-to-webp/scripts/convert.py https://images.pexels.com/photos/1640777/pexels-photo-1640777.jpeg

Batch processing multiple URLs

python .claude/skills/image-to-webp/scripts/convert.py \
  https://images.pexels.com/photos/1640777/pexels-photo-1640777.jpeg \
  https://images.pexels.com/photos/842571/pexels-photo-842571.jpeg

Custom dimensions (e.g., for hero images)

python .claude/skills/image-to-webp/scripts/convert.py \
  https://images.pexels.com/photos/1640777/pexels-photo-1640777.jpeg \
  --width 1920 --height 1080

Custom output name and quality

python .claude/skills/image-to-webp/scripts/convert.py \
  https://images.pexels.com/photos/1640777/pexels-photo-1640777.jpeg \
  --output hero-image --quality 90

Keep aspect ratio (fits within 800x600 without cropping)

python .claude/skills/image-to-webp/scripts/convert.py \
  https://images.pexels.com/photos/1640777/pexels-photo-1640777.jpeg \
  --keep-ratio

Save to custom directory

python .claude/skills/image-to-webp/scripts/convert.py \
  https://images.pexels.com/photos/1640777/pexels-photo-1640777.jpeg \
  --dest ./public/images

Output

The script outputs the path to each created WebP file and reports the file size. For batch operations, it shows progress and a summary at the end.

Dependencies

Requires Python 3 with Pillow and requests libraries. If not installed, run:

pip install Pillow requests

Notes

Auto-generated filenames are derived from the URL or use sequential numbering for batches
WebP format provides excellent compression while maintaining quality
Default 800x600 at quality 85 typically produces files of 50-150KB
The --keep-ratio flag prevents cropping by fitting the image within the target dimensions