A comprehensive image optimization and upload utility designed for seamless AI agent workflows and batch processing.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install image-compressor
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-compressor 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 Compressor?
The Image Compressor skill is a powerful tool powered by the rv-image-optimize engine, specifically optimized for Openclaw Skills. It allows developers and AI agents to programmatically compress, resize, and convert images into modern high-efficiency formats like WebP and AVIF. Beyond simple compression, it integrates sophisticated upload capabilities, allowing for a complete asset processing pipeline from local optimization to remote server storage.
This skill is built with an agent-first philosophy, providing structured JSON outputs that allow AI agents to report precise success metrics and handle errors gracefully. It prioritizes data safety by defaulting to non-destructive workflows, ensuring your original source files remain intact while generating optimized versions for web use.
Image Compressor Use Cases
- Reducing image file sizes for web performance optimization
- Batch converting entire directories of JPEG or PNG files into WebP or AVIF
- Resizing high-resolution photography to specific web-friendly dimensions during compression
- Automating the upload of optimized assets to a remote API using FormData
- Implementing resumable, chunked uploads for large image archives in agent workflows
- Integrating image processing into CI/CD pipelines or automated developer scripts
How Image Compressor Works
- Input Analysis: The skill identifies the source file or directory provided in the command.
- Transformation Configuration: It parses specific flags for format conversion (WebP/AVIF), quality levels, and dimension limits (max-width/max-height).
- Optimization Execution: The rv-image-optimize engine processes the images, applying compression algorithms to reduce file size while maintaining visual integrity.
- Optional Upload/Pipeline: If configured, the skill initiates a network request to upload the processed files to a specified endpoint using FormData or chunked transfer.
- Structured Reporting: The process concludes by generating a JSON-formatted summary containing statistics like total files processed, success/failure counts, and final file paths for the Openclaw Skills environment.
Image Compressor Setup
To use this skill, ensure you have Node.js installed and install the core optimization package. You can either install it globally or run it directly via npx.
# Install globally
npm install -g rv-image-optimize
# Or verify installation version
rv-image-optimize --version
For AI agents integrated with Openclaw Skills, ensure the bin is accessible in the environment's PATH.
Image Compressor Data Schema & Taxonomy
The skill utilizes a combination of CLI flags and JSON configuration files to manage metadata and processing logic:
| Parameter | Type | Description |
|---|---|---|
--format |
String | Target format: webp, avif, jpeg, png |
--quality |
Number | Compression quality (default: 82) |
--output-dir |
Path | Destination for optimized files |
--config |
JSON File | Upload settings including headers and endpoints |
--json |
Flag | Enables structured output for agent parsing |
Upload Config Schema:
url: The target API endpoint.formData: Key-value pairs for additional fields.chunkUpload: Settings for resumable large file transfers.
Image Compressor Advanced Features
- Pipeline Mode: Combine compression and uploading into a single atomic operation to minimize disk I/O and script complexity.
- Chunked Resumable Uploads: Support for splitting large files into fragments to handle unstable network conditions and resume interrupted transfers.
- Agent-Ready JSON Outputs: Provides machine-readable summaries including HTTP status codes and transformation metrics.
- Safety Constraints: Built-in protection against overwriting source files unless explicitly requested via the --replace-original flag.
- Format Conversion: Native support for converting legacy formats into next-generation AVIF and WebP files for maximum efficiency.
SKILL.md
Loading
Related Openclaw Skills
Stump Removal Video
An AI-powered video generation tool that transforms raw tree service data into high-impact marketing videos for stump grinding and lawn reclamation.
Skills Audit
A security-first auditing and monitoring tool designed to verify the integrity and safety of Openclaw Skills through static analysis and change tracking.
Generate PPTX
A specialized AI agent skill that converts multi-turn requirement gathering and SVG slide designs into downloadable PPTX files.
DiePre Vision Cognition
An industrial-grade cognitive vision framework that merges packaging machine perception with advanced AI reasoning for precise manufacturing quality control.
Xiaoxia Image Gen
A versatile text-to-image generation skill for AI agents that integrates multiple top-tier models like MiniMax, OpenAI, and Stability AI.
Amazon Niche Market Intelligence (Jiimore)
An AI-powered tool for retrieving deep Amazon niche market insights, including competition, demand, and profitability metrics via the Jiimore data service.
Featured*
