A comprehensive utility for reading, analyzing, and manipulating a wide variety of image formats using native macOS tools and ffmpeg.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install image-handler
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-handler 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 Handler?
The Image Handler is a high-performance utility designed to give AI agents deep control over visual assets within the Openclaw Skills ecosystem. By leveraging the power of the native macOS sips tool alongside ffmpeg, it provides a unified interface for processing everything from standard JPEGs to modern WebP and HEIC files. This skill is particularly valuable for developers who need to bridge the gap between raw image data and actionable media assets.
Whether you are preparing assets for a web project or managing a personal photo library, this skill provides the programmatic hooks necessary to automate complex transformations. It excels at maintaining technical precision during batch operations, ensuring that metadata, aspect ratios, and compression levels are handled according to professional standards within your Openclaw Skills environment.
Image Handler Use Cases
- Automating the conversion of iPhone HEIC photos to cross-platform JPEG or PNG formats.
- Bulk resizing of high-resolution images for web optimization and faster load times.
- Sanitizing images by stripping sensitive EXIF and location metadata before publication.
- Programmatically generating thumbnails or cropped assets for content management systems.
- Extracting frame sequences from GIFs or short video clips for technical analysis.
How Image Handler Works
- Analysis: The skill triggers on image file mentions to extract metadata such as dimensions, color profiles, and format details.
- Validation: It determines the optimal tool for the task, utilizing sips for native macOS speed or ffmpeg for advanced codec support.
- Processing: Executes the requested transformation, whether it involves rotating, flipping, resizing, or format conversion.
- Verification: Confirms the output file integrity and provides the agent with the new file path or updated metadata.
Image Handler Setup
The Image Handler relies on macOS native utilities and optional third-party binaries. To get the most out of these Openclaw Skills, ensure your environment is prepared:
# Verify native sips installation
sips --help
# Install ffmpeg for WebP and advanced format support
brew install ffmpeg
# Ensure internal scripts are executable
chmod +x ./scripts/*.sh
Image Handler Data Schema & Taxonomy
The skill manages data through a combination of CLI flags and structured script outputs:
| Feature | Specification |
|---|---|
| Input Formats | PNG, JPEG, GIF, WebP, TIFF, BMP, HEIC, SVG, ICO |
| Operations | Convert, Resize, Rotate, Flip, Crop, Pad |
| Metadata | Depth, DPI, Pixels, Format, Profile |
| Scripting | image_info.sh, convert_image.sh, batch_convert.sh |
Image Handler Advanced Features
- Multi-format batch processing for entire directories of disparate image types.
- High-fidelity HEIC to JPEG conversion specifically optimized for mobile photography.
- Frame-by-frame extraction and animation assembly using ffmpeg integration.
- Precision coordinate-based cropping for generating consistent UI assets.
- Privacy-first workflows that automatically strip all metadata using Openclaw Skills logic.
SKILL.md
Loading
Related Openclaw Skills
Document Handler
A versatile utility for extracting text, metadata, and converting various document formats including PDF, Word, and Excel.
Audio Handler
A comprehensive audio processing toolkit for AI agents to analyze, convert, and manipulate media files using industry-standard CLI tools.
Tencent Cloud Human Portrait Segmentation
A professional-grade portrait segmentation skill for AI agents to perform automatic image matting and contour recognition.
Tencent Cloud Image Face Fusion
A professional-grade face fusion skill that seamlessly merges user faces with template images using high-performance Tencent Cloud AI.
API Wrapper Generator
A powerful automation utility that transforms REST APIs into fully documented Openclaw Skills using OpenAPI specifications.
neckr0ik-automation-templates
A comprehensive library of 50+ production-ready automation templates for n8n, Make.com, and Zapier accessible via CLI.
Featured*
