Baoyu Compress Image

Baoyu-compress-image compresses images to WebP or PNG format using the best available system tool (sips, cwebp, ImageMagick, or Sharp) selected based on what's installed. It serves developers and content creators who need to reduce image file sizes or convert images to optimized web formats. The skill eliminates the need to manually manage multiple image compression tools by automatically detecting and using the most suitable option available on the user's system.

skills.sh installs: 28.6K
GitHub stars: 27.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add jimliu/baoyu-skills --skill baoyu-compress-image --agent claude-code

Installs into .claude/skills of the current project.

Files

Image Compressor

Tool auto-selection order: sips → cwebp → ImageMagick → Sharp.

Script Directory

{baseDir} = this SKILL.md's directory. Resolve ${BUN_X}: bun if installed; else npx -y bun; else suggest installing bun. Replace {baseDir} and ${BUN_X} with actual values.

Script	Purpose
`scripts/main.ts`	Image compression CLI

Preferences (EXTEND.md)

First found wins:

Priority	Path	Scope
1	`.baoyu-skills/baoyu-compress-image/EXTEND.md`	Project
2	`${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-compress-image/EXTEND.md`	XDG
3	`$HOME/.baoyu-skills/baoyu-compress-image/EXTEND.md`	User home

If none found, use defaults. EXTEND.md supports: default format, default quality, keep-original preference.

Usage

${BUN_X} {baseDir}/scripts/main.ts <input> [options]
${BUN_X} {baseDir}/scripts/main.ts image.png                    # → WebP, replaces original
${BUN_X} {baseDir}/scripts/main.ts image.png -f png --keep      # keep PNG format and original
${BUN_X} {baseDir}/scripts/main.ts ./images/ -r -q 75           # directory, recursive

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly