jimliu/baoyu-skills

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 reduce image file size.

All-time #832 Trending #3096 Hot #5252 First seen Jan 19, 2026
8-week activity · all time api

Installation

$ npx skills add jimliu/baoyu-skills --skill baoyu-compress-image

Summary

  • Compresses images to WebP or PNG with automatic tool selection based on system availability.
  • Supports WebP (default), PNG, and JPEG output formats with configurable quality (0–100, default 80) Automatically selects best available compression tool: sips, cwebp, ImageMagick, or Sharp Processes single files or directories recursively with options to keep originals or replace in-place Customizable via EXTEND.md configuration files at project, user home, or XDG config locations

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed Apr 20, 2026

The skill is a legitimate image compression utility that optimizes local images using standard system tools and the well-known 'sharp' library. It contains no malicious patterns or data exfiltration behaviors.

snyk LOW

Analyzed Apr 20, 2026

No issues detected.

socket Score 0.9000 · 0 alerts

Analyzed Apr 20, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from jimliu/baoyu-skills · top by installs.

npx skills add jimliu/baoyu-skills

Browse all from jimliu/baoyu-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 25.8K
License LICENSE
Default branch main
Open issues 8
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.56.1
Declared agents clawdbot
More metadata
openclaw
{"homepage":"https:\/\/github.com\/JimLiu\/baoyu-skills#baoyu-compress-image","requires":{"anyBins":["bun","npx"]}}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,409 B
  • docs SUMMARY.md 205 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 27,209 installs

SKILL.md

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 ${BUNX} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun. Replace {baseDir} and ${BUNX} 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 ${XDGCONFIGHOME:-$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.