Tuzi Compress Image

This handles image compression with automatic tool fallback, trying sips, then cwebp, then ImageMagick, then Sharp until something works. It defaults to WebP at 80% quality and can process single files or entire directories recursively. The EXTEND.md configuration system is thoughtful, checking project level first then falling back to your home directory for personal defaults. You can keep originals or replace them, output as WebP, PNG, or JPEG, and get either human readable or JSON output. It's the kind of thing you'd wire up to a pre-commit hook or run manually when a designer dumps a folder of PNGs into your repo and you need to shrink them fast.

skills.sh installs: 172
GitHub stars: 39
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add tuziapi/tuzi-skills --skill tuzi-compress-image --agent claude-code

Installs into .claude/skills of the current project.

Files

Image Compressor

Compresses images using best available tool (sips → cwebp → ImageMagick → Sharp).

Script Directory

Scripts in scripts/ subdirectory. Replace ${SKILL_DIR} with this SKILL.md's directory path.

Script	Purpose
`scripts/main.ts`	Image compression CLI

Preferences (EXTEND.md)

Use Bash to check EXTEND.md existence (priority order):

# Check project-level first
test -f .tuzi-skills/tuzi-compress-image/EXTEND.md && echo "project"

# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.tuzi-skills/tuzi-compress-image/EXTEND.md" && echo "user"

┌────────────────────────────────────────────────────────┬───────────────────┐ │ Path │ Location │ ├────────────────────────────────────────────────────────┼───────────────────┤ │ .tuzi-skills/tuzi-compress-image/EXTEND.md │ Project directory │ ├────────────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.tuzi-skills/tuzi-compress-image/EXTEND.md │ User home │ └────────────────────────────────────────────────────────┴───────────────────┘

SKILL.md on GitHub

Details

Repository: github.com/tuziapi/tuzi-skills
First seen: Jun 3, 2026