Baoyu Compress Image

by jimliu1567581c26ecNo license26K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 4 weeks ago

Compresses images to WebP (default) or PNG with automatic tool selection. Use when user asks to "compress image", "optimize image", "convert to webp", or reduce image file size.

Includes scriptsDesign & Creative

AI-generated overview

Compresses images to WebP, PNG, or JPEG using the best available tool, with quality and recursion options.

What it does: Runs a TypeScript CLI that compresses a single image file or a directory of images, converting them to WebP (default), PNG, or JPEG. It selects among available tools (sips, cwebp, ImageMagick, Sharp), supports quality settings, recursive directory processing, keeping originals, and JSON output. It can read optional EXTEND.md preference files for default format, quality, and keep-original behavior.
When to use it: Use when a user asks to compress an image, optimize an image, convert images to WebP, or reduce image file size, including batch processing of image directories.
Requirements: Requires a Bun runtime or npx (to run bun); relies on one of sips, cwebp, ImageMagick, or Sharp being available. Ships an executable script at scripts/main.ts. Optional EXTEND.md configuration files are read from project, XDG, or home locations.

Image Compressor

Compresses images using best available tool (sips → cwebp → ImageMagick → Sharp).

Script Directory

Scripts in scripts/ subdirectory. {baseDir} = this SKILL.md's directory path. Resolve ${BUN_X} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun. Replace {baseDir} and ${BUN_X} with actual values.

Preferences (EXTEND.md)

Check EXTEND.md in priority order — the first one 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

Options

Option	Short	Description	Default
`<input>`		File or directory	Required
`--output`	`-o`	Output path	Same path, new ext
`--format`	`-f`	webp, png, jpeg	webp
`--quality`	`-q`	Quality 0-100	80
`--keep`	`-k`	Keep original	false
`--recursive`	`-r`	Process subdirs	false
`--json`		JSON output	false

Examples

bash

# Single file → WebP (replaces original)${BUN_X} {baseDir}/scripts/main.ts image.png
# Keep PNG format${BUN_X} {baseDir}/scripts/main.ts image.png -f png --keep
# Directory recursive${BUN_X} {baseDir}/scripts/main.ts ./images/ -r -q 75
# JSON output${BUN_X} {baseDir}/scripts/main.ts image.png --json

# Single file → WebP (replaces original)${BUN_X} {baseDir}/scripts/main.ts image.png
# Keep PNG format${BUN_X} {baseDir}/scripts/main.ts image.png -f png --keep
# Directory recursive${BUN_X} {baseDir}/scripts/main.ts ./images/ -r -q 75
# JSON output${BUN_X} {baseDir}/scripts/main.ts image.png --json

Output:

Extension Support

Custom configurations via EXTEND.md. See Preferences section for paths and supported options.

Source and attribution

Source:jimliu/baoyu-skillsinskills/baoyu-compress-imageat commit1567581

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Baoyu Compress Image

Image Compressor

Script Directory

Preferences (EXTEND.md)

Usage

Options

Examples

Extension Support

Source and attribution

More from jimliu/baoyu-skills

Baoyu Wechat Summary

Baoyu Diagram

Release Skills

More in Design & Creative

Theme Factory

Slack Gif Creator

Frontend Design

Canvas Design

Brand Guidelines

Frontend Design