What problem does it solve? Image folders in projects often contain unoptimized PNG and JPEG files that bloat repositories and slow down page loads. This Skill losslessly compresses those images in bulk while keeping originals untouched, with a mandatory dry-run preview so you always know what will change before anything is written to disk. ## Core Features & Use Cases - Lossless Compression: PNG uses Pillow's optimize mode with compress_level 9; JPEG keeps the original quantization tables (quality='keep') and only re-encodes entropy, preserving pixels, ICC profiles, and EXIF data. - Safe Dry-Run Workflow: Always previews candidate files, per-file savings, and total size reduction before writing; output goes to a compressed/ subdirectory so originals stay intact. - No-Gain Protection: Files that would grow larger are automatically kept as original bytes, so the output directory remains a complete drop-in replacement. - Use Case: Before shipping a web or mobile app, point the Skill at your assets/ folder to shrink dozens of PNG/JPEG images by 5–30% without any visual quality loss, then replace the originals with one copy command. ## Quick Start Ask the agent to losslessly compress the images in your assets folder, for example: "Run pp-image-compress on my src/assets folder and show me the dry-run preview first."
