Skip to the usage guide
Baoyu Compress Imageby jimliu

Baoyu Compress Image Skill.

Convert and compress image assets with explicit quality and preservation options.

  • Image Compression
  • WebP
Source Review · baoyu-compress-imageSKILL.md
Task Convert and compress image assets with explicit quality and preservation options. Produces Compressed images in the chosen format and destination. Before You Start The default keep-original setting is false, so preservation must be chosen deliberately.
Editorial summary · source reviewed 2026-11-02 · not a generated example

01 What It Does

Convert and compress image assets with explicit quality and preservation options

Compress image files to WebP, PNG or JPEG using automatic tool selection, quality settings and explicit original-file preservation.

Source-based workflowNot an execution benchmark

The Working Approach

Baoyu Compress Image wraps an image-compression script with file, directory and output options. WebP is the default output, while PNG and JPEG are also documented choices. The workflow selects an available image tool in a stated order: sips, cwebp, ImageMagick and then Sharp.

The key decision is what happens to the source files. The documented default does not keep originals, while the keep option preserves them. Project and user preferences can also supply format, quality and preservation choices. This makes an explicit output location and original-file policy useful inputs before any batch processing begins.

Expected Deliverables

  • Compressed images in the chosen format and destination.
  • A reported conversion and size-change result for processed assets.
  • Optional structured JSON output for a larger asset workflow.
See the Example Brief

From Brief to Review

  1. 01
    Resolve preferences and scope

    Identify the exact file or directory and read applicable EXTEND.md preferences. Specify whether subdirectories are included and whether originals must be preserved.

  2. 02
    Choose output settings

    Select WebP, PNG or JPEG, an output path and quality. The documented quality default is 80; the appropriate result depends on the image content.

  3. 03
    Run the scoped conversion

    Use the bundled main.ts script through Bun or the documented fallback. Allow its tool selection to choose an available backend.

  4. 04
    Review the resulting assets

    Check generated images and reported size changes. Confirm that the chosen preservation and recursion settings were respected.

02 When to Use It

When to Use It

The default keep-original setting is false, so preservation must be chosen deliberately.

A Good Fit

  • Website asset preparationReduce image file weight while delivering a format the site can use.
  • Scoped batch conversionApply explicit quality and preservation settings to a known directory of assets.

Limits to Check

  • Original preservationThe default keep-original setting is false, so preservation must be chosen deliberately.
  • Local tool dependencyThe workflow requires its bundled main.ts script and Bun, or the documented npx-based Bun fallback.
  • Variable compression resultsThe example reduction in the source is illustrative, not a promised reduction for every image.

Bring These Inputs

  • Exact assetsProvide the file or directory and whether recursion is intended.
  • Output policySpecify destination, format and whether originals must remain.
  • Quality targetSet quality or identify the visual standard to review after compression.

03 Decisions That Matter

Decisions That Matter

  1. Backend selection

    The script can use available system image tools or Sharp.

  2. Reusable preferences

    EXTEND.md can store format, quality and original-preservation defaults.

  3. Batch-friendly reporting

    JSON output can feed a larger asset-processing workflow.

04 Try a Focused Brief

Try a Focused Brief

The example brief below has not been tested. Check the skill’s setup before using it.

Review the Source and Setup

Provide the file or directory and whether recursion is intended.

Upstream Source File
https://github.com/jimliu/baoyu-skills/blob/0a27d7d40e79cfe42334e2e9130a1e41a499ca54/skills/baoyu-compress-image/SKILL.md

The reference below opens the upstream instructions. Review the repository setup before using them; it is not an installation command.

Start With One Deliverable

Adapt the scope, source material and constraints in this brief before running the skill.

Example Brief
Use baoyu-compress-image on the exported screenshots in the specified task directory. Preserve every original and write compressed WebP files to a separate output directory. Process only the top-level images in this pass. Read any project preferences, then use quality 80 for an initial sample. Compare the resulting image visually before applying the settings to the rest. Report the output paths and actual before-and-after sizes, and flag any screenshot whose text or fine detail becomes visibly worse. Do not treat the source's example savings as an expected result.

Inspect the Result

Check the actual output against these observable criteria.

  • Originals remain present when preservation was requested.
  • Only the selected directory scope is processed.
  • Compressed files open correctly and retain acceptable visible detail.

OpenDesign provides a local design workspace for coding agents. This listing does not mean the skill is bundled or that its external tools, credentials and software dependencies are included.

05 Source and License

Source and License

This page describes the pinned source revision linked below. Upstream behavior and requirements can change.

Source Owner
jimliu
Skill File
SKILL.md
License
MIT
Reviewed Snapshot
2026-11-02 · 0a27d7d40e79

Reading Notes

  1. License ScopePinned repository LICENSE text verified; complete archive filename inventory found no more-specific LICENSE/COPYING/NOTICE file under this skill path. Classification is for the reviewed upstream source, not generated output or third-party dependencies. README specifies GitHub repository MIT unless otherwise noted, while published ClawHub distributions use MIT-0; this entry classifies the pinned GitHub source.
Editorial Source Summary
Convert and compress image assets with explicit quality and preservation options.

Original summary by OpenDesign, based on the linked source. Repository stars are a dated popularity signal, not skill usage or a quality score.

06 Questions Before You Start

Questions Before You Start

Is WebP the only output?

No. The options also include PNG and JPEG.

Will it keep my source files automatically?

The documented default is false. Use the keep option or an appropriate preference to preserve originals.

Can it process subfolders?

Yes, with the recursive option. Recursion is disabled by default.

OpenDesign

Keep Your Brief and Design Work Together.

Keep your brief, source material and design work together in a local workspace. Check the skill’s own setup before adding it to your workflow.

Upstream Source File
https://github.com/jimliu/baoyu-skills/blob/0a27d7d40e79cfe42334e2e9130a1e41a499ca54/skills/baoyu-compress-image/SKILL.md