Baoyu Compress Image

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

Security Scan

The skill's code, runtime instructions, and requested resources are coherent with an image-compression utility and do not request unrelated credentials or network installs.

Purpose & Capability

Name/description match the included scripts and CLI behavior. Required runtimes (bun or npx) are consistent with running a TypeScript script packaged with the skill. No unrelated binaries, credentials, or config paths are requested.

Instruction Scope

SKILL.md only instructs running the included script and reading optional EXTEND.md config files from project/XDG/home locations — behavior appropriate for user-configurable tooling. The script performs filesystem operations (recursing directories, renaming originals to *_original when --keep is false, and writing output files). This file-modifying behavior is expected but could be surprising if users assume originals are preserved by default.

Install Mechanism

No install spec or remote downloads are present. The script is included in the bundle and relies on local runtime (bun or npx); there is no network fetch in the provided files.

Credentials

No environment variables or secrets are requested. The skill reads configuration files from standard user/project config locations (EXTEND.md) which is proportional to its purpose. It does spawn external image tools (sips, cwebp, convert) and dynamically imports 'sharp' if needed — requiring those tools or packages is reasonable for image processing but may require users to install them.

Persistence & Privilege

always is false and the skill is user-invocable. It does not request permanent platform-wide privileges or modify other skills' configurations.

Assessment

This skill appears to be a straightforward image compressor. Before installing or running it: 1) Be aware it modifies files — by default it replaces originals and renames the original to *_original unless you pass --keep; back up important images first. 2) You may need bun/npx and native tools (cwebp, ImageMagick 'convert', or the sharp Node module) installed for best behavior. 3) The skill reads EXTEND.md from project/XDG/home config locations for preferences — review those files if present. 4) There are no requested credentials or network calls in the bundle, but inspect runtime output/errors when first running it to confirm it behaves as expected.

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.

Script	Purpose
scripts/main.ts	Image compression CLI

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

${BUN_X} {baseDir}/scripts/main.ts <input> [options]

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

# 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:

image.png → image.webp (245KB → 89KB, 64% reduction)

Extension Support

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