← Back to Skills Marketplace
pratiknarola

Image Tools (ImageMagick)

by Pratik Narola · GitHub ↗ · v1.0.0 · MIT-0
linuxdarwin ⚠ suspicious
43
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install image-tools-magick
Description
Comprehensive image editing toolkit using ImageMagick. Resize, crop, composite (overlay), pad, annotate, adjust (brightness/contrast/blur/rotate/flip), remov...
README (SKILL.md)

Image Tools (ImageMagick)

Pixel-level image manipulation via shell scripts. For AI-based editing (add/remove content with prompts), see nano-banana-pro.

Requires: imagemagick (apt install imagemagick / brew install imagemagick)

Scripts

All scripts are in scripts/ relative to this skill. All output to a new file (non-destructive).

🔧 resize.sh — Resize images

scripts/resize.sh \x3Cinput> \x3Cgeometry> [output]
Geometry Effect
800x Width 800, keep aspect ratio
800x600 Fit within 800x600
800x600! Force exact 800x600 (distort)
50% Scale to 50%
800x800\> Shrink only if larger

✂️ crop.sh — Crop images

scripts/crop.sh \x3Cinput> \x3CWxH+X+Y> [output]
  • 500x500+100+50 — crop 500x500 starting at pixel (100, 50)
  • 500x500+center — center crop (special mode)

🧩 composite.sh — Overlay / place image on image

scripts/composite.sh \x3Cbackground> \x3Coverlay> [output] [options]

Options: --gravity, --offset +X+Y, --resize GEO, --opacity PCT

  • Place logo on photo: scripts/composite.sh bg.jpg logo.png out.jpg --gravity southeast
  • Watermark: scripts/composite.sh bg.jpg mark.png out.jpg --opacity 30 --resize 200x200

📐 pad.sh — Add padding / extend canvas

scripts/pad.sh \x3Cinput> \x3CWxH> [output] [--color COL] [--gravity POS]
  • Make square: scripts/pad.sh wide.jpg 1080x1080 --color white
  • Transparent pad: scripts/pad.sh icon.png 512x512 --color none

🎨 adjust.sh — Brightness, contrast, rotate, flip, blur, etc.

scripts/adjust.sh \x3Cinput> [output] [options]

Options: --brightness N, --contrast N, --saturation N, --rotate N, --flip, --flop, --grayscale, --blur 0xN, --sharpen 0xN, --negate, --border WxH, --border-color COL

🔤 annotate.sh — Add text overlay

scripts/annotate.sh \x3Cinput> \x3Ctext> [output] [options]

Options: --font, --size, --color, --bg, --gravity, --offset, --stroke, --stroke-width

🧹 remove-bg.sh — Remove solid background color → transparent

scripts/remove-bg.sh \x3Cinput> \x3Coutput> [tolerance%] [color]
  • Remove white: scripts/remove-bg.sh icon.png clean.png
  • Remove green screen: scripts/remove-bg.sh photo.png clean.png 25 "#00FF00"

🔄 convert-format.sh — Format conversion

scripts/convert-format.sh \x3Cinput> \x3Coutput> [--quality N] [--strip]

Supports: PNG, JPG, WebP, GIF, BMP, TIFF

ℹ️ info.sh — Image metadata

scripts/info.sh \x3Cimage>

Direct ImageMagick (for anything not covered by scripts)

# Tile/montage multiple images
montage img1.jpg img2.jpg img3.jpg -geometry 300x300+5+5 montage.jpg

# Generate app icon set
for size in 1024 512 256 128 64 32 16; do
  convert icon.png -resize ${size}x${size} icon-${size}.png
done

# Rounded corners
convert input.png \( +clone -alpha extract -draw 'fill black polygon 0,0 0,15 15,0 fill white circle 15,15 15,0' \
  \( +clone -flip \) -compose Multiply -composite \( +clone -flop \) -compose Multiply -composite \) \
  -alpha off -compose CopyOpacity -composite rounded.png

# Append images (horizontal / vertical)
convert img1.jpg img2.jpg +append horizontal.jpg    # side by side
convert img1.jpg img2.jpg -append vertical.jpg      # stacked

AI-Based Editing

For adding/removing objects, style transfer, or content-aware edits, use the nano-banana-pro skill (Gemini image editing):

uv run /root/shared/skills/nano-banana-pro/scripts/generate_image.py \
  --prompt "remove the person on the left" \
  --input-image photo.jpg \
  --filename edited.png
Usage Guidance
Review before installing. Use only with trusted inputs, and avoid passing untrusted annotation text, paths, colors, offsets, rotation, blur, sharpen, or border values until the helper scripts replace eval with safely quoted argument arrays and basic option validation.
Capability Tags
crypto
Capability Assessment
Purpose & Capability
The artifacts match the stated ImageMagick image-editing purpose: resize, crop, annotate, adjust, composite, pad, convert, remove backgrounds, and inspect metadata. The main concern is implementation safety, not a mismatch in advertised capability.
Instruction Scope
The skill tells agents to pass user-chosen image parameters into shell scripts, and annotate.sh and adjust.sh then re-parse those values through eval. That gives crafted text, colors, geometry, paths, or transform options more authority than the documented image operation requires.
Install Mechanism
No install-time execution, package-install hook, credential request, persistence setup, or hidden installer behavior was found in the provided artifacts or metadata.
Credentials
Local ImageMagick scripts are proportionate for this purpose, but eval-based command construction is not proportionate because it can expand a normal image-editing request into arbitrary local shell execution.
Persistence & Privilege
No background workers, startup persistence, privilege escalation, credential harvesting, or network exfiltration behavior was identified. The risk is limited to invocation-time shell injection in specific helpers.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install image-tools-magick
  3. After installation, invoke the skill by name or use /image-tools-magick
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: resize, crop, composite, pad, annotate, adjust, remove-bg, convert-format, info — full ImageMagick toolkit for AI agents
Metadata
Slug image-tools-magick
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Image Tools (ImageMagick)?

Comprehensive image editing toolkit using ImageMagick. Resize, crop, composite (overlay), pad, annotate, adjust (brightness/contrast/blur/rotate/flip), remov... It is an AI Agent Skill for Claude Code / OpenClaw, with 43 downloads so far.

How do I install Image Tools (ImageMagick)?

Run "/install image-tools-magick" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Image Tools (ImageMagick) free?

Yes, Image Tools (ImageMagick) is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Image Tools (ImageMagick) support?

Image Tools (ImageMagick) is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux, darwin).

Who created Image Tools (ImageMagick)?

It is built and maintained by Pratik Narola (@pratiknarola); the current version is v1.0.0.

💬 Comments