Image Works

Image Workshop Skill

Local-first batch image processing toolkit. Compress, resize, convert formats, add watermarks, clean EXIF, crop — all on your machine with no image upload. Includes presets for Chinese social platforms (WeChat, Xiaohongshu, Taobao, etc.).

Core Capabilities

• Compress: Quality target, size target, lossless, or auto-smart
• Resize: Fixed dimensions, scale ratio, max-edge constraint, batch uniform
• Convert: JPEG ↔ PNG ↔ WebP ↔ AVIF ↔ TIFF (bidirectional)
• Watermark: Text or image, custom position/opacity, tile mode
• EXIF: Remove all metadata, remove GPS only, or view metadata
• Crop: Region crop, aspect-ratio crop (1:1, 4:3, 16:9, 3:4)
• Presets: One-shot platform-optimized processing (WeChat, Xiaohongshu, Taobao, etc.)

Chinese Platform Presets

Usage

clawhub run image-works --input  --op  --output 

Options

Operations

Compress: {"type":"compress","quality":80,"target_size_kb":500} Resize: {"type":"resize","width":1200,"height":900,"fit":"inside"} Convert: {"type":"convert","format":"webp","quality":85} Watermark: {"type":"watermark","text":"© My Name","position":"bottom-right","opacity":0.5} EXIF: {"type":"exif","action":"remove"} Crop: {"type":"crop","aspect_ratio":"1:1"}

Operations are applied in array order.

Sample Prompts

1. Batch compress all JPEGs in a directory (most common)

clawhub run image-works --input './photos/*.jpg' \
  --op '[{"type":"compress","quality":80}]' \
  --output ./compressed/
# → 47 files processed, 156.2MB → 42.8MB (72.6% saved)

2. Xiaohongshu preset (one-shot)

clawhub run image-works --input ./product-photos/ \
  --preset xiaohongshu \
  --output ./xiaohongshu-ready/
# → Auto-resize to 3:4 (1080×1440), compress, export as JPEG

3. Add watermark with resize + format conversion

clawhub run image-works --input ./portfolio/ \
  --op '[{"type":"watermark","text":"© My Name","position":"bottom-right","opacity":0.3},{"type":"convert","format":"webp","quality":90}]' \
  --output ./watermarked-webp/
# → Watermarked + WebP converted

4. EXIF cleanup for privacy-safe sharing

clawhub run image-works --input ./vacation-photos/ \
  --op '[{"type":"exif","action":"remove"}]' \
  --output ./safe-to-share/
# → All GPS/device metadata removed

5. Batch resize for e-commerce (Taobao main image)

clawhub run image-works --input ./raw-products/ \
  --op '[{"type":"resize","width":800,"height":800,"fit":"cover"},{"type":"compress","quality":85}]' \
  --output ./taobao-ready/
# → Uniform 800×800 product images, optimized

First-Success Path

Step 1: Install → clawhub install image-works
Step 2: Run → clawhub run image-works --input ~/Pictures/ --op '{"type":"compress","quality":80}'
Step 3: See space-savings report → immediate value
Step 4: Explore presets → xiaohongshu, wechat-cover, etc.

Core Scripts