baoyu compress image
- Repo stars 0
- Author updated Jul 4, 2026, 01:22 AM
- Author repo baoyu-skills
- Domain
- Design
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 92 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @JimLiu · v1.56.1 · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- macOS · Linux · Windows
- Runtime requirements
- Bun
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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
```bash
${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
```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
```
**Output**:
```
image.png → image.webp (245KB → 89KB, 64% reduction)
```
## Extension Support
Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.
Sections and files
Listed in source order.
sections -> Script Directory → Preferences (EXTEND.md) → Usage → Options → Examples → Extension Support
terms -> EXTEND.md supports · Output · Preferences · Compresses images using best available tool (sips → cwebp → ImageMagick → Sharp). · Scripts in scripts/ subdirectory. · If none found, use defaults. · EXTEND.md supports: Default format, default quality, keep-original preference. · Custom configurations via EXTEND.md.
files/cmd -> scripts/ · {baseDir} · ${BUN_X} · bun · npx · npx -y bun · scripts/main.ts · .baoyu-skills/baoyu-compress-image/EXTEND.md
body sha256 -> 47d92af0d850
Script Directory
Scripts in
scripts/subdirectory.{baseDir}= this SKILL.md's directory path. Resolve${BUN_X}runtime: ifbuninstalled →bun; ifnpxavailable →npx -y bun; else suggest installing bun. Replace{baseDir}and${BUN_X}with actual values. Script · Purposescripts/main.ts· Image compression CLIPreferences (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 homeOptions
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 · 80Examples
Output:
Extension Support
Custom configurations via EXTEND.md. See Preferences section for paths and supported options.