An automated image optimization skill for macOS that ensures your media meets platform size limits before sending.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install image-compression
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install image-compression using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Image Compression Skill?
The image compression skill is a specialized utility for the Openclaw Skills ecosystem designed to handle media optimization tasks natively on macOS. It leverages the powerful sips command-line tool to automatically monitor file sizes and apply compression when images exceed specific platform limits, such as the 10MB threshold for Telegram. By integrating this skill, users can ensure their AI agents handle high-resolution media efficiently without manual intervention.
This skill is particularly valuable for developers and power users who frequently share screenshots or design assets through messaging platforms. It provides a seamless bridge between local file management and cloud-based communication by intelligently adjusting image dimensions and quality while preserving the integrity of the original source files.
Image Compression Skill Use Cases
- Sending high-resolution photos to Telegram without hitting the 10MB file limit.
- Optimizing screenshots for WeChat File Transfer Assistant to ensure rapid delivery.
- Reducing bandwidth consumption when uploading assets to remote servers or repositories.
- Batch resizing images to a standard width for documentation or web use cases within Openclaw Skills.
How Image Compression Skill Works
- The skill receives an image path and checks the file size against a predefined threshold (default is 10MB).
- If the file exceeds the limit, it calculates the necessary adjustments based on the max_width and quality parameters.
- It executes the macOS native sips utility to perform the compression and resizing.
- A new version of the image is created with a _compressed suffix to prevent overwriting the original file.
- The skill returns the path of the optimized file, which can then be passed to subsequent messaging or storage workflows.
Image Compression Skill Setup
This skill requires macOS as it depends on the system-integrated sips tool. To use it within your Openclaw Skills environment, follow these steps:
# Compress an image using default settings (1024px width, 85% quality)
bash scripts/compress_image.sh "/path/to/your/image.png"
# Compress with a custom width of 800px
bash scripts/compress_image.sh "/path/to/your/image.png" 800
# Compress with custom width and quality (80%)
bash scripts/compress_image.sh "/path/to/your/image.png" 800 80
Image Compression Skill Data Schema & Taxonomy
The skill manages configuration through the following parameters and generates structured output for AI agents:
| Parameter | Default Value | Description |
|---|---|---|
| max_width | 1024px | The maximum width allowed for the output image. |
| quality | 85 | The compression quality ratio (0-100). |
| max_size | 10MB | The file size limit that triggers the compression workflow. |
| formats | PNG, JPEG, GIF | Supported file extensions for processing. |
| filename | [name]_compressed | The naming convention for generated files. |
Image Compression Skill Advanced Features
- Direct Telegram Integration: Includes specialized scripts to compress and send media directly to a Telegram Chat ID.
- WeChat Automation: Optimized for sending files to the WeChat File Transfer Assistant automatically.
- Intelligent Format Handling: Supports multiple image formats including JPEG, PNG, and GIF with specific optimization logic for each.
- Non-Destructive Workflow: Always preserves original assets by generating unique output paths, a core safety feature of Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Nansen Smart Alerts
A command-line management tool for Nansen smart alerts to track real-time token flows, smart money movements, and contract calls.
Figma Desktop MCP Skill
A local MCP integration that connects AI agents directly to Figma Desktop for seamless design generation and code export without OAuth.
ocli-api
A streamlined tool that converts OpenAPI/Swagger specifications into functional CLI commands without needing an MCP server.
Turkish Locale Skill Pack
A comprehensive localization ecosystem providing Turkish personality templates, real-time news, BIST100 financial tracking, and automated daily briefs.
XHS Note Generator
An AI-powered automation skill designed to generate professional XiaoHongShu notes, including copy, tags, and images via the Xiaonian API.
Dashboard Humanize
A professional CLI utility designed to remove AI signatures and humanize text using the Dashboard Console API.
Featured*
