Image Handler

Read, analyze metadata, convert formats, resize, rotate, crop, compress, and batch process PNG, JPG, GIF, WebP, TIFF, BMP, HEIC, SVG, and ICO images.

Security Scan

The skill's files and runtime instructions are coherent with an image-processing utility: it manipulates local image files using sips/ffmpeg and does not request credentials, network access, or other unrelated privileges.

Purpose & Capability

Name/description (image read/convert/resize/etc.) matches the included scripts and SKILL.md examples. The scripts perform local file conversions, metadata extraction, and batch processing as advertised.

Instruction Scope

Instructions and scripts operate on local image files and reference only local commands (sips, ffmpeg, standard shell tools). Minor issues: SKILL.md includes example invocation paths rooted at ~/Dropbox/jarvis/skills/... which are just usage examples and not required by the scripts; SKILL.md references sips/ffmpeg but required-binaries metadata is empty (see install_mechanism). There are no instructions to read unrelated system files, transmit data externally, or access credentials.

Install Mechanism

No install spec (instruction-only plus bundled scripts). This is the lowest-risk install model. The scripts will be written to disk when the skill is installed, which is expected. There are no downloads from arbitrary URLs or archive extraction steps.

Credentials

The skill declares no required environment variables or credentials, which is appropriate. One small inconsistency: SKILL.md expects sips (macOS) and optionally ffmpeg to be available, but the registry metadata does not list required binaries—users should ensure those tools are present for full functionality.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or global agent configs, and does not store credentials. It runs only when invoked.

Assessment

This skill appears to do only local image processing and does not request secrets or network access. Before installing: 1) Confirm you have the needed tools (sips is macOS-only; ffmpeg is optional for WebP/HEIC/animated GIFs). 2) Review and run the scripts on non-sensitive test images first — image-processing binaries like ffmpeg/sips have historically had vulnerabilities, so avoid processing untrusted images on high-privilege hosts. 3) The SKILL.md examples reference a developer's ~/Dropbox path but the scripts themselves use relative/input arguments — you can move or invoke them from anywhere. If you need the skill to operate on remote images or to upload results, verify those steps separately because this skill does not implement network transfer or authentication.

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