1---
2name: baoyu-compress-image
3description: 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.
4version: 1.56.1
5metadata:
6  openclaw:
7    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-compress-image
8    requires:
9      anyBins:
10        - bun
11        - npx
12---
13 
14# Image Compressor
15 
16Compresses images using best available tool (sips → cwebp → ImageMagick → Sharp).
17 
18## Script Directory
19 
20Scripts 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.
21 
22| Script | Purpose |
23|--------|---------|
24| `scripts/main.ts` | Image compression CLI |
25 
26## Preferences (EXTEND.md)
27 
28Check EXTEND.md in priority order — the first one found wins:
29 
30| Priority | Path | Scope |
31|----------|------|-------|
32| 1 | `.baoyu-skills/baoyu-compress-image/EXTEND.md` | Project |
33| 2 | `${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-compress-image/EXTEND.md` | XDG |
34| 3 | `$HOME/.baoyu-skills/baoyu-compress-image/EXTEND.md` | User home |
35 
36If none found, use defaults.
37 
38**EXTEND.md supports**: Default format, default quality, keep-original preference.
39 
40## Usage
41 
42```bash
43${BUN_X} {baseDir}/scripts/main.ts <input> [options]
44```
45 
46## Options
47 
48| Option | Short | Description | Default |
49|--------|-------|-------------|---------|
50| `<input>` | | File or directory | Required |
51| `--output` | `-o` | Output path | Same path, new ext |
52| `--format` | `-f` | webp, png, jpeg | webp |
53| `--quality` | `-q` | Quality 0-100 | 80 |
54| `--keep` | `-k` | Keep original | false |
55| `--recursive` | `-r` | Process subdirs | false |
56| `--json` | | JSON output | false |
57 
58## Examples
59 
60```bash
61# Single file → WebP (replaces original)
62${BUN_X} {baseDir}/scripts/main.ts image.png
63 
64# Keep PNG format
65${BUN_X} {baseDir}/scripts/main.ts image.png -f png --keep
66 
67# Directory recursive
68${BUN_X} {baseDir}/scripts/main.ts ./images/ -r -q 75
69 
70# JSON output
71${BUN_X} {baseDir}/scripts/main.ts image.png --json
72```
73 
74**Output**:
75```
76image.png → image.webp (245KB → 89KB, 64% reduction)
77```
78 
79## Extension Support
80 
81Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.
82