questnova502/claude-skills-sync/baoyu-compress-image

Name: baoyu-compress-image
Author: questnova502

Claude Code and agent skill by questnova502/claude-skills-sync

Trust tier 3

community

Source check pending

Checking that the SKILL.md file is still in the repository.

Cross-platform image compression skill. Converts images to WebP by default with PNG-to-PNG support. Uses system tools (sips, cwebp, ImageMagick) with Sharp fallback.

Install

npx vskill@latest install questnova502/claude-skills-sync/baoyu-compress-image

SKILL.md

Image Compressor

Cross-platform image compression with WebP default output, PNG-to-PNG support, preferring system tools with Sharp fallback.

Script Directory

Important: All scripts are located in the scripts/ subdirectory of this skill.

Agent Execution Instructions:

Determine this SKILL.md file's directory path as SKILL_DIR
Script path = ${SKILL_DIR}/scripts/<script-name>.ts
Replace all ${SKILL_DIR} in this document with the actual path

Script Reference:

Script	Purpose
`scripts/main.ts`	CLI entry point for image compression

Quick Start

bash

# Compress to WebP (default)
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png
 
# Keep original format (PNG → PNG)
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --format png
 
# Custom quality
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png -q 75
 
# Process directory
npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/ -r

Commands

Single File Compression

bash

# Basic (converts to WebP, replaces original)
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png
 
# Custom output path
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png -o compressed.webp
 
# Keep original file
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --keep
 
# Custom quality (0-100, default: 80)
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png -q 75
 
# Keep original format
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png -f png

Directory Processing

bash

# Process all images in directory
npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/
 
# Recursive processing
npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/ -r
 
# With custom quality
npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/ -r -q 75

Output Formats

bash

# Plain text (default)
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png
 
# JSON output
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --json

Options

Option	Short	Description	Default
`<input>`		Input file or directory	Required
`--output <path>`	`-o`	Output path	Same path, new extension
`--format <fmt>`	`-f`	webp, png, jpeg	webp
`--quality <n>`	`-q`	Quality 0-100	80
`--keep`	`-k`	Keep original file	false
`--recursive`	`-r`	Process directories recursively	false
`--json`		JSON output	false
`--help`	`-h`	Show help

Compressor Selection

Priority order (auto-detected):

sips (macOS built-in, WebP support since macOS 11)
cwebp (Google's official WebP tool)
ImageMagick (convert command)
Sharp (npm package, auto-installed by Bun)

The skill automatically selects the best available compressor.

Output Format

Text Mode (default)

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

JSON Mode

json

{
  "input": "image.png",
  "output": "image.webp",
  "inputSize": 250880,
  "outputSize": 91136,
  "ratio": 0.36,
  "compressor": "sips"
}

Directory JSON Mode

json

{
  "files": [...],
  "summary": {
    "totalFiles": 10,
    "totalInputSize": 2508800,
    "totalOutputSize": 911360,
    "ratio": 0.36,
    "compressor": "sips"
  }
}

Examples

Compress single image

bash

npx -y bun ${SKILL_DIR}/scripts/main.ts photo.png
# photo.png → photo.webp (1.2MB → 340KB, 72% reduction)

Compress with custom quality

bash

npx -y bun ${SKILL_DIR}/scripts/main.ts photo.png -q 60
# photo.png → photo.webp (1.2MB → 280KB, 77% reduction)

Keep original format

bash

npx -y bun ${SKILL_DIR}/scripts/main.ts screenshot.png -f png --keep
# screenshot.png → screenshot-compressed.png (500KB → 380KB, 24% reduction)

Process entire directory

bash

npx -y bun ${SKILL_DIR}/scripts/main.ts ./screenshots/ -r
# Processed 15 files: 12.5MB → 4.2MB (66% reduction)

Get JSON for scripting

bash

npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --json | jq '.ratio'

Extension Support

Custom configurations via EXTEND.md.

Check paths (priority order):

.baoyu-skills/baoyu-compress-image/EXTEND.md (project)
~/.baoyu-skills/baoyu-compress-image/EXTEND.md (user)

If found, load before workflow. Extension content overrides defaults.

Security

Security scanPassed, 90 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingskills/baoyu-compress-image/SKILL.md

Popularity

Repository stars: 4
Repository forks: 4
7-day trend score: 8

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 14 May 2026, 5 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/questnova502/claude-skills-sync/baoyu-compress-image/badge)](https://verified-skill.com/skills/questnova502/claude-skills-sync/baoyu-compress-image)

Something wrong with this skill or its page? Tell us.