AgentSkillsCN

image-optimizer

优化并压缩图片以供网页使用。通过有损/无损压缩技术，减小 JPEG、PNG、GIF 图片的文件大小。可将图片调整至最大尺寸，转换为 WebP 格式，并递归处理整个目录。适用于图片过大、需要压缩，或需要格式转换时使用。

SKILL.md
--- frontmatter
name: image-optimizer
description: Optimize and compress images for web use. Reduces file sizes of JPEG, PNG, GIF images using lossy/lossless compression. Can resize images to maximum dimensions, convert to WebP format, and process entire directories recursively. Use when images are too large for web, need compression, or need format conversion.
license: MIT
compatibility: Requires imagemagick, jpegoptim, pngquant, and webp packages
metadata:
  author: exedev
  version: "1.0"

Image Optimizer

Compress and optimize images for web delivery, similar to Squoosh.

Quick Start

bash
# Ensure dependencies are installed
scripts/install-deps.sh

# Optimize images
scripts/imgopt.sh [OPTIONS] <files or directories>

Common Use Cases

Optimize a single image

bash
scripts/imgopt.sh photo.jpg

Compress all images in a folder

bash
scripts/imgopt.sh images/

Resize and compress for web (recommended for large images)

bash
scripts/imgopt.sh -q 80 -w 1920 images/

Create WebP versions (best compression for modern browsers)

bash
scripts/imgopt.sh --webp images/

Process recursively and keep originals

bash
scripts/imgopt.sh -r --keep --webp ./website/images/

Output to a different directory

bash
scripts/imgopt.sh -o optimized/ *.jpg *.png

Preview what would happen (dry run)

bash
scripts/imgopt.sh -n -r images/

Options Reference

OptionDescriptionDefault
-q, --quality NQuality level 1-10080
-w, --max-width NMaximum width in pixelsunlimited
-h, --max-height NMaximum height in pixelsunlimited
-o, --output DIROutput directoryin-place
--webpAlso create WebP versionsoff
--keepKeep originals (save as .opt.ext)off
-r, --recursiveProcess directories recursivelyoff
-n, --dry-runShow what would be doneoff
-v, --verboseShow detailed progressoff

Supported Formats

  • •Input: JPEG, PNG, GIF, BMP, TIFF
  • •Output: Same format (optimized) + optional WebP

Recommended Settings by Use Case

Use CaseCommand
Blog images-q 80 -w 1200 --webp
Hero/banner images-q 85 -w 1920 --webp
Thumbnails-q 75 -w 400
E-commerce products-q 85 -w 1000 --webp
Maximum compression-q 60 -w 1920 --webp

Tips

  1. •Always test on copies first - Use --keep or -o output/ until you're happy with results
  2. •WebP is best for web - Creates files typically 25-35% smaller than optimized JPEG
  3. •Quality 80 is a good default - Below 70 you may notice artifacts
  4. •Resize matters most - A 4000px image resized to 1920px will be much smaller regardless of compression

See references/REFERENCE.md for detailed technical information.