How do I install the Baoyu Compress Image skill?

Run npx skillmds@latest add tentacle-pro/baoyu-compress-image in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Baoyu Compress Image safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Baoyu Compress Image?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Baoyu Compress Image free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Baoyu Compress Image?

tentacle-pro (@tentacle-pro) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Baoyu Compress Image by tentacle-pro

Name: Baoyu Compress Image
Author: tentacle-pro

File contents

baoyu-compress-image

Auto-compresses images using the best available CLI tool on the system (sips, cwebp, convert, or sharp).

This has been specifically adapted for the Obsidian Creator Vault:

Fast Web-focused: Defaults to generating .jpg with 65 quality (perfect for most platform limits < 1MB).
Clean Vault: When run in default mode (replace), it doesn't clutter your Assets/ with _original files. Instead, it backs up the original unmodified file to Archive/Original-Images/.
Dependency Sandboxing: All runtime is wrapped through bun and isolated inside .agents/skills.

Installation & System Requirements

This script automatically detects your OS and uses the fastest and highest quality image engine it can find in this order:

macOS sips (Built-in, Highly Recommended)
macOS ships with sips natively. No installation required.
(Under the hood: sips -s format jpeg -s formatOptions 65 <input> --out <output>)
cwebp (Best for webp targets)
- macOS: brew install webp
- Ubuntu/Debian: sudo apt install webp
ImageMagick (convert)
- macOS: brew install imagemagick
- Linux: sudo apt install imagemagick
sharp (Node.js fallback for Windows / Non-Native Envs)
Automatically installed when you run the local bun install command. The sharp engine handles compression via libvips without needing external binaries.

First Time Setup (TS Environment):

cd .agents/skills/baoyu-compress-image
bun install

Usage

Run the script using bun from the root of the vault.

bun .agents/skills/baoyu-compress-image/scripts/main.ts <input> [options]

Options

Option	Short	Description	Default
`<input>`		Input target (File or directory)	Required
`--output`	`-o`	Strict output file path	Same dir as input
`--format`	`-f`	Output format (`jpeg`, `webp`, `png`)	`jpeg`
`--quality`	`-q`	Quality Level `0-100`	`65`
`--keep`	`-k`	Keep original file in-place (don't archive it)	`false`
`--recursive`	`-r`	Process directories recursively	`false`

Examples & Workflows

1. Compress a generated AI image for publishing (Default)

bun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/cover-draft.png

Effect: It creates Assets/cover-draft.jpg and safely moves cover-draft.png out of the way into Archive/Original-Images/.

2. Compress an image but keep it as WebP format

bun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/screenshot.png -f webp

3. Test different quality manually and keep the original there

bun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/photo.png -q 80 --keep

4. Batch-compress an entire directory

bun .agents/skills/baoyu-compress-image/scripts/main.ts "00 Inbox/" -r

---name: baoyu-compress-imagedescription: Compresses images to JPEG/WebP/PNG using an automated multi-platform CLI (sips, cwebp, sharp). Washed for Obsidian Creator Vault: defaults to JPEG at 65 quality (for <1MB output), and auto-archives original files.---# baoyu-compress-imageAuto-compresses images using the best available CLI tool on the system (`sips`, `cwebp`, `convert`, or `sharp`).This has been specifically adapted for the Obsidian Creator Vault:- **Fast Web-focused**: Defaults to generating `.jpg` with `65` quality (perfect for most platform limits < 1MB).- **Clean Vault**: When run in default mode (replace), it doesn't clutter your `Assets/` with `_original` files. Instead, it backs up the original unmodified file to `Archive/Original-Images/`. - **Dependency Sandboxing**: All runtime is wrapped through `bun` and isolated inside `.agents/skills`.## Installation & System RequirementsThis script automatically detects your OS and uses the fastest and highest quality image engine it can find in this order:1. **macOS `sips` (Built-in, Highly Recommended)** macOS ships with `sips` natively. No installation required. *(Under the hood: `sips -s format jpeg -s formatOptions 65 <input> --out <output>`)* 2. **`cwebp` (Best for webp targets)** - macOS: `brew install webp` - Ubuntu/Debian: `sudo apt install webp`3. **ImageMagick (`convert`)** - macOS: `brew install imagemagick` - Linux: `sudo apt install imagemagick`4. **`sharp` (Node.js fallback for Windows / Non-Native Envs)** Automatically installed when you run the local `bun install` command. The sharp engine handles compression via libvips without needing external binaries.**First Time Setup (TS Environment):**```bashcd .agents/skills/baoyu-compress-imagebun install```## UsageRun the script using `bun` from the root of the vault. ```bashbun .agents/skills/baoyu-compress-image/scripts/main.ts <input> [options]```### Options| Option | Short | Description | Default ||--------|-------|-------------|---------|| `<input>` | | Input target (File or directory) | Required || `--output` | `-o` | Strict output file path | Same dir as input || `--format` | `-f` | Output format (`jpeg`, `webp`, `png`) | `jpeg` || `--quality` | `-q` | Quality Level `0-100` | `65` || `--keep` | `-k` | Keep original file in-place (don't archive it) | `false` || `--recursive` | `-r` | Process directories recursively | `false` |## Examples & Workflows**1. Compress a generated AI image for publishing (Default)**```bashbun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/cover-draft.png```*Effect*: It creates `Assets/cover-draft.jpg` and safely moves `cover-draft.png` out of the way into `Archive/Original-Images/`.**2. Compress an image but keep it as WebP format**```bashbun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/screenshot.png -f webp```**3. Test different quality manually and keep the original there**```bashbun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/photo.png -q 80 --keep```**4. Batch-compress an entire directory**```bashbun .agents/skills/baoyu-compress-image/scripts/main.ts "00 Inbox/" -r```

Frequently asked questions

Baoyu Compress Image