---

name: image-handler description: Read, analyze, convert, and manipulate image files (PNG, JPG, GIF, WebP, TIFF, BMP, HEIC, SVG, ICO). Use when working with images: reading metadata, converting formats, resizing, rotating, compressing, or batch processing. Triggers on mentions of image files, file paths with image extensions, or requests to process/convert images.

Image Handler

Analyze, convert, and manipulate image files.

Supported Formats

Format	Extensions	Read	Convert	Metadata
PNG	.png	✅	✅	✅
JPEG	.jpg, .jpeg	✅	✅	✅
GIF	.gif	✅	✅	✅
WebP	.webp	✅	✅	✅
TIFF	.tiff, .tif	✅	✅	✅
BMP	.bmp	✅	✅	✅
HEIC	.heic, .heif	✅	✅	✅
SVG	.svg	✅	✅	-
ICO	.ico	✅	✅	✅

Quick Commands

Metadata (sips - built-in macOS)

# Get all properties
sips -g all image.jpg

# Get specific properties
sips -g pixelWidth -g pixelHeight -g format -g dpiWidth -g dpiHeight image.jpg

# JSON-like output (parseable)
sips -g all image.jpg 2>&1 | tail +2

Convert Formats

# Convert to PNG
sips -s format png input.jpg --out output.png

# Convert to JPEG with quality
sips -s format jpeg -s formatOptions 85 input.png --out output.jpg

# Convert HEIC to JPEG
sips -s format jpeg input.heic --out output.jpg

# Batch convert (shell)
for f in *.heic; do sips -s format jpeg "$f" --out "${f%.heic}.jpg"; done

Resize

# Resize to max dimensions (maintains aspect ratio)
sips --resampleWidth 1920 image.jpg --out resized.jpg
sips --resampleHeight 1080 image.jpg --out resized.jpg

# Resize to exact dimensions
sips --resampleWidth 1920 --resampleHeight 1080 image.jpg --out resized.jpg

# Scale by percentage
sips --resampleWidth 50% image.jpg --out half.jpg

Rotate & Flip

# Rotate 90 degrees clockwise
sips --rotate 90 image.jpg --out rotated.jpg

# Rotate 180 degrees
sips --rotate 180 image.jpg --out rotated.jpg

# Flip horizontal
sips --flip horizontal image.jpg --out flipped.jpg

# Flip vertical
sips --flip vertical image.jpg --out flipped.jpg

Crop

# Crop to specific pixels (x, y, width, height)
sips --cropToHeightWidth 500 500 image.jpg --out cropped.jpg

# Crop from center
sips --cropToHeightWidth 500 500 --cropOffset 100 100 image.jpg --out cropped.jpg

Strip Metadata

# Remove EXIF and all metadata
sips --deleteProperty all image.jpg --out clean.jpg

ffmpeg (advanced operations)

# WebP to PNG
ffmpeg -i input.webp output.png

# Extract frames from GIF
ffmpeg -i animation.gif frame_%03d.png

# Create GIF from images
ffmpeg -framerate 10 -i frame_%03d.png output.gif

# Resize with ffmpeg
ffmpeg -i input.jpg -vf scale=1920:-1 output.jpg

# Convert video to GIF
ffmpeg -i video.mp4 -vf "fps=10,scale=480:-1" output.gif

Scripts

image_info.sh

Get comprehensive image metadata.

~/Dropbox/jarvis/skills/image-handler/scripts/image_info.sh <image>

convert_image.sh

Convert between formats with options.

~/Dropbox/jarvis/skills/image-handler/scripts/convert_image.sh <input> <output> [quality]

batch_convert.sh

Convert all images in a directory.

~/Dropbox/jarvis/skills/image-handler/scripts/batch_convert.sh <input_dir> <output_format> [output_dir]

Workflow

1. Get info — sips -g all for dimensions, format, metadata
2. Convert if needed — Change format for compatibility
3. Resize/optimize — Reduce file size for web/sharing
4. Strip metadata — Remove EXIF for privacy

Notes

• sips is built into macOS — no installation needed
• ffmpeg handles WebP, animated GIFs, and video-to-image
• For HEIC (iPhone photos), convert to JPEG for compatibility
• SVG is text-based — use cat or text tools
• For OCR on images, use the document-handler skill