Agent skill

Imagemagick

Guide for using ImageMagick command-line tools to perform advanced image processing tasks including format conversion, resizing, cropping, effects, transformations, and batch operations.

MITAuto-check: notesMedia & Creative

Install Imagemagick

skills CLI

$ npx skills add einverne/dotfiles --skill imagemagick -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install einverne/dotfiles imagemagick --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/einverne/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/claude/skills/imagemagick .claude/skills/imagemagick && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "imagemagick" agent skill from https://github.com/einverne/dotfiles/tree/master/claude/skills/imagemagick into .claude/skills/imagemagick/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "imagemagick", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/einverne/dotfiles/tree/master/claude/skills/imagemagick

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add einverne/dotfiles --skill imagemagick -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install einverne/dotfiles imagemagick --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/einverne/dotfiles.git skills-src && mkdir -p .agents/skills && cp -r skills-src/claude/skills/imagemagick .agents/skills/imagemagick && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "imagemagick" agent skill from https://github.com/einverne/dotfiles/tree/master/claude/skills/imagemagick into .agents/skills/imagemagick/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "imagemagick", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add einverne/dotfiles --skill imagemagick -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install einverne/dotfiles imagemagick --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/einverne/dotfiles.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/claude/skills/imagemagick .cursor/skills/imagemagick && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "imagemagick" agent skill from https://github.com/einverne/dotfiles/tree/master/claude/skills/imagemagick into .cursor/skills/imagemagick/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "imagemagick", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/einverne/dotfiles.git --path claude/skills/imagemagick

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add einverne/dotfiles --skill imagemagick -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install einverne/dotfiles imagemagick --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/einverne/dotfiles.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/claude/skills/imagemagick .gemini/skills/imagemagick && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "imagemagick" agent skill from https://github.com/einverne/dotfiles/tree/master/claude/skills/imagemagick into .gemini/skills/imagemagick/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "imagemagick", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install einverne/dotfiles imagemagick

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add einverne/dotfiles --skill imagemagick -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/einverne/dotfiles.git skills-src && mkdir -p .github/skills && cp -r skills-src/claude/skills/imagemagick .github/skills/imagemagick && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "imagemagick" agent skill from https://github.com/einverne/dotfiles/tree/master/claude/skills/imagemagick into .github/skills/imagemagick/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "imagemagick", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add einverne/dotfiles --skill imagemagick -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install einverne/dotfiles imagemagick --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/einverne/dotfiles.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/claude/skills/imagemagick .opencode/skills/imagemagick && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "imagemagick" agent skill from https://github.com/einverne/dotfiles/tree/master/claude/skills/imagemagick into .opencode/skills/imagemagick/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "imagemagick", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: imagemagick
GitHub stars: 121
Token cost: ~3.8k tokens
SKILL.md length: 566 words
Files: 1
Skills in repo: 39
Repo updated: Sep 9, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Guide for using ImageMagick command-line tools to perform advanced image processing tasks including format conversion, resizing, cropping, effects, transformations, and batch operations.

Works in 10 steps: Always use -strip to remove metadata… → Set appropriate quality (85 for JPEG is… → Use +repage after crop to reset virtual… → …
Manipulating images programmatically via shell commands
SKILL.md covers When to Use This Skill, Core Concepts, Installation and Common Operations, plus 4 more sections
Calls magick, brew and apt-get

What it does

Imagemagick is an agent skill from einverne/dotfiles. Guide for using ImageMagick command-line tools to perform advanced image processing tasks including format conversion, resizing, cropping, effects, transformations, and batch operations. Use when manipulating images programmatically via shell commands.

Its SKILL.md is about 3.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative. The repository describes itself as: my personal dotfiles managed by dotbot, zinit. The licence is MIT.

When your agent uses it

Manipulating images programmatically via shell commands

Example prompts

“/imagemagick”

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

Always use -strip to remove metadata (reduces file size)
Set appropriate quality (85 for JPEG is good balance)
Use +repage after crop to reset virtual canvas
Quote file paths with spaces: "my image.jpg"
Test on sample before batch processing
Backup originals when using mogrify
Use -auto-orient to respect EXIF orientation
Progressive JPEGs for web (use -interlace Plane)
Limit memory for large batches to prevent crashes
Check output after complex operations

What it can do on your machine

Read from SKILL.md and the folder at commit c6c0686. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- magick
- brew
- apt-get
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- imagemagick.org
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Imagemagick loads about 3.8k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 566 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~66
When it runs · the whole SKILL.md, loaded when a task matches: ~3.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteRuns commands with sudoSKILL.md:69
```
sudo apt-get install imagemagick
```
NoteRuns commands with sudoSKILL.md:597
```
sudo nano /etc/ImageMagick-6/policy.xml
```
NoteRuns commands with sudoSKILL.md:599
```
sudo nano /etc/ImageMagick-7/policy.xml
```

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from einverne/dotfiles at commit c6c0686, republished under its MIT licence (© einverne). 566 words, ~3,794 tokens.

Download SKILL.mdSave it as .claude/skills/imagemagick/SKILL.md (or your agent's skills folder).

name: imagemagick
description: Guide for using ImageMagick command-line tools to perform advanced image processing tasks including format conversion, resizing, cropping, effects, transformations, and batch operations. Use when manipulating images programmatically via shell commands.
license: MIT
version: 1.0.0

ImageMagick Skill

ImageMagick is a comprehensive, free, open-source software suite for creating, editing, converting, and manipulating images in over 250 formats. This skill covers command-line usage of ImageMagick tools for programmatic image processing.

When to Use This Skill

Use this skill when:

Converting images between formats (PNG, JPEG, WebP, GIF, etc.)
Resizing, cropping, or transforming images
Applying effects, filters, or adjustments to images
Creating thumbnails or image previews
Batch processing multiple images
Compositing or combining images
Adding watermarks, borders, or text to images
Optimizing images for web or print

Core Concepts

Primary Commands

ImageMagick provides several command-line tools:

magick: Modern unified command for all operations (ImageMagick v7+)
convert: Legacy command for image conversion and manipulation (still widely used)
mogrify: Modify images in-place (batch processing)
identify: Display image metadata and properties
montage: Create image composites and contact sheets
composite: Overlay images

Note: In ImageMagick v7+, magick is the recommended command. Legacy convert syntax: convert input.png output.jpg becomes magick input.png output.jpg

Command Structure

Basic syntax:

bash

magick [input-options] input-file [operations] [output-options] output-file

Operations are applied left to right in the order specified.

Geometry Specifications

ImageMagick uses geometry strings for dimensions:

100x100 - Resize to fit within 100×100 (maintains aspect ratio)
100x100! - Force exact size (ignores aspect ratio)
100x100^ - Fill 100×100 (may crop, maintains aspect ratio)
100x - Resize to width 100 (auto height)
x100 - Resize to height 100 (auto width)
50% - Scale to 50% of original
100x100+10+20 - 100×100 region at offset (10, 20)

Installation

macOS:

bash

brew install imagemagick

Ubuntu/Debian:

bash

sudo apt-get install imagemagick

Verify installation:

bash

magick -version
# or
convert -version

Common Operations

Format Conversion

Convert between image formats:

bash

# PNG to JPEG
magick input.png output.jpg

# JPEG to WebP
magick input.jpg output.webp

# Multiple formats
magick input.png output.jpg output.webp output.gif

# Set JPEG quality (0-100)
magick input.png -quality 85 output.jpg

# Convert with compression
magick input.png -quality 90 -strip output.jpg

Resizing

Resize images while maintaining aspect ratio:

bash

# Resize to fit within 800×600
magick input.jpg -resize 800x600 output.jpg

# Resize to specific width (auto height)
magick input.jpg -resize 800x output.jpg

# Resize to specific height (auto width)
magick input.jpg -resize x600 output.jpg

# Resize to exact dimensions (ignores aspect ratio)
magick input.jpg -resize 800x600! output.jpg

# Scale by percentage
magick input.jpg -resize 50% output.jpg

# Resize only if larger (shrink only)
magick input.jpg -resize 800x600\> output.jpg

# Resize only if smaller (enlarge only)
magick input.jpg -resize 800x600\< output.jpg

Cropping

Extract portions of images:

bash

# Crop 400×400 pixels starting at (100, 100)
magick input.jpg -crop 400x400+100+100 output.jpg

# Crop from center
magick input.jpg -gravity center -crop 400x400+0+0 output.jpg

# Remove virtual canvas after crop
magick input.jpg -crop 400x400+100+100 +repage output.jpg

# Crop to aspect ratio from center
magick input.jpg -gravity center -crop 16:9 output.jpg

Resize + Crop (Thumbnail Generation)

Common pattern for creating square thumbnails:

bash

# Resize to fill 100×100, then crop from center
magick input.jpg -resize 100x100^ -gravity center -extent 100x100 output.jpg

# Alternative using crop
magick input.jpg -resize 275x275^ -gravity center -crop 275x275+0+0 +repage output.jpg

# Create thumbnail with specific background
magick input.jpg -resize 100x100 -background white -gravity center -extent 100x100 output.jpg

Effects and Filters

Apply visual effects:

bash

# Blur
magick input.jpg -blur 0x8 output.jpg

# Gaussian blur with radius 5, sigma 3
magick input.jpg -gaussian-blur 5x3 output.jpg

# Sharpen
magick input.jpg -sharpen 0x1 output.jpg

# Grayscale
magick input.jpg -colorspace Gray output.jpg

# Sepia tone
magick input.jpg -sepia-tone 80% output.jpg

# Negate (invert colors)
magick input.jpg -negate output.jpg

# Edge detection
magick input.jpg -edge 3 output.jpg

# Emboss
magick input.jpg -emboss 2 output.jpg

# Oil painting effect
magick input.jpg -paint 4 output.jpg

# Charcoal drawing
magick input.jpg -charcoal 2 output.jpg

Adjustments

Modify brightness, contrast, and colors:

bash

# Adjust brightness (+/- 0-100)
magick input.jpg -brightness-contrast 10x0 output.jpg

# Adjust contrast
magick input.jpg -brightness-contrast 0x20 output.jpg

# Both brightness and contrast
magick input.jpg -brightness-contrast 10x20 output.jpg

# Adjust saturation
magick input.jpg -modulate 100,150,100 output.jpg

# Adjust hue
magick input.jpg -modulate 100,100,120 output.jpg

# Auto level (normalize contrast)
magick input.jpg -auto-level output.jpg

# Auto gamma correction
magick input.jpg -auto-gamma output.jpg

# Normalize (stretch histogram)
magick input.jpg -normalize output.jpg

Rotation and Flipping

Transform image orientation:

bash

# Rotate 90 degrees clockwise
magick input.jpg -rotate 90 output.jpg

# Rotate 180 degrees
magick input.jpg -rotate 180 output.jpg

# Rotate counter-clockwise
magick input.jpg -rotate -90 output.jpg

# Rotate with background color
magick input.jpg -background white -rotate 45 output.jpg

# Flip vertically
magick input.jpg -flip output.jpg

# Flip horizontally (mirror)
magick input.jpg -flop output.jpg

# Auto-orient based on EXIF
magick input.jpg -auto-orient output.jpg

Borders and Frames

Add borders to images:

bash

# Add 10px black border
magick input.jpg -border 10x10 output.jpg

# Add border with specific color
magick input.jpg -bordercolor red -border 10x10 output.jpg

# Add frame effect
magick input.jpg -mattecolor gray -frame 10x10+5+5 output.jpg

# Add shadow effect
magick input.jpg \( +clone -background black -shadow 80x3+5+5 \) \
  +swap -background white -layers merge +repage output.jpg

Text and Watermarks

Add text overlays:

bash

# Add simple text
magick input.jpg -pointsize 30 -fill white -annotate +10+30 "Hello" output.jpg

# Add text with positioning
magick input.jpg -gravity south -pointsize 20 -fill white \
  -annotate +0+10 "Copyright 2025" output.jpg

# Add text with background
magick input.jpg -gravity center -pointsize 40 -fill white \
  -undercolor black -annotate +0+0 "Watermark" output.jpg

# Add semi-transparent watermark
magick input.jpg \( -background none -fill "rgba(255,255,255,0.5)" \
  -pointsize 50 label:"DRAFT" \) -gravity center -compose over -composite output.jpg

Compositing

Combine multiple images:

bash

# Overlay watermark on image
magick input.jpg watermark.png -gravity southeast -composite output.jpg

# Overlay with transparency
magick input.jpg watermark.png -gravity center \
  -compose over -composite output.jpg

# Tile pattern
magick input.jpg pattern.png -compose over -tile -composite output.jpg

# Side-by-side images
magick input1.jpg input2.jpg +append output.jpg

# Stack images vertically
magick input1.jpg input2.jpg -append output.jpg

Format-Specific Options

Optimize for different formats:

bash

# JPEG with quality and strip metadata
magick input.png -quality 85 -strip output.jpg

# Progressive JPEG
magick input.png -quality 85 -interlace Plane output.jpg

# PNG with compression level (0-9)
magick input.jpg -quality 95 output.png

# WebP with quality
magick input.jpg -quality 80 output.webp

# WebP lossless
magick input.png -define webp:lossless=true output.webp

# GIF with optimization
magick input.png -colors 256 output.gif

# Transparent background PNG
magick input.jpg -transparent white output.png

Batch Processing

Using mogrify

Modify multiple files in-place:

bash

# Convert all JPEGs to PNG in current directory
mogrify -format png *.jpg

# Resize all images in directory
mogrify -resize 800x600 *.jpg

# Apply to output directory (preserves originals)
mogrify -path ./output -resize 800x600 *.jpg

# Batch thumbnail generation
mogrify -path ./thumbnails -resize 275x275^ -gravity center \
  -crop 275x275+0+0 +repage *.jpg

# Batch format conversion with quality
mogrify -path ./optimized -format jpg -quality 85 -strip *.png

Using shell loops

For more complex batch operations:

bash

# Convert with custom naming
for img in *.jpg; do
  magick "$img" -resize 800x600 "resized_$img"
done

# Multi-step processing
for img in *.jpg; do
  magick "$img" -resize 1920x1080^ -gravity center \
    -crop 1920x1080+0+0 +repage -quality 85 "processed_$img"
done

# Different output format
for img in *.png; do
  magick "$img" -quality 90 "${img%.png}.jpg"
done

Image Information

Using identify

Get image metadata:

bash

# Basic info
identify image.jpg

# Detailed information
identify -verbose image.jpg

# Format only
identify -format "%f: %wx%h %b\n" image.jpg

# Specific attributes
identify -format "%f: %wx%h, %[colorspace], %[type]\n" image.jpg

# File size
identify -format "%f: %b\n" image.jpg

# Multiple images
identify *.jpg

Show full SKILL.md (235 more words)Show less

Common format strings

%f - filename
%w - width
%h - height
%b - file size
%[colorspace] - colorspace
%[type] - image type
%[channels] - number of channels
%[depth] - bit depth

Advanced Techniques

Creating Contact Sheets

Use montage:

bash

# Basic grid
montage *.jpg -geometry 200x200+2+2 contact-sheet.jpg

# With labels
montage *.jpg -geometry 200x200+2+2 -label '%f' contact-sheet.jpg

# Custom layout (3 columns)
montage *.jpg -tile 3x -geometry 200x200+5+5 contact-sheet.jpg

Animated GIFs

Create animations:

bash

# Create GIF from images
magick -delay 100 -loop 0 frame*.png animated.gif

# Optimize GIF
magick animated.gif -fuzz 5% -layers Optimize optimized.gif

# Extract frames from GIF
magick animated.gif frame_%03d.png

Complex Pipelines

Chain multiple operations:

bash

# Resize, crop, add border, adjust brightness
magick input.jpg \
  -resize 1000x1000^ \
  -gravity center \
  -crop 1000x1000+0+0 +repage \
  -bordercolor black -border 5x5 \
  -brightness-contrast 5x10 \
  -quality 90 \
  output.jpg

# Create thumbnail with watermark
magick input.jpg \
  -resize 400x400^ \
  -gravity center \
  -extent 400x400 \
  \( watermark.png -resize 100x100 \) \
  -gravity southeast -geometry +10+10 \
  -composite \
  output.jpg

Performance Optimization

Memory and Speed

bash

# Limit memory usage (useful for large images)
magick -limit memory 2GB -limit map 4GB input.jpg -resize 50% output.jpg

# Set thread count
magick -limit thread 4 input.jpg -resize 50% output.jpg

# Use streaming for large files
magick -define stream:buffer-size=0 huge.jpg -resize 50% output.jpg

Quality vs Size Trade-offs

bash

# High quality (larger file)
magick input.jpg -quality 95 output.jpg

# Balanced (recommended for web)
magick input.jpg -quality 85 -strip output.jpg

# Lower quality (smaller file)
magick input.jpg -quality 70 -sampling-factor 4:2:0 -strip output.jpg

# Progressive JPEG (better for web)
magick input.jpg -quality 85 -interlace Plane -strip output.jpg

Common Patterns

Avatar/Profile Picture Generation

bash

# Square thumbnail from any aspect ratio
magick input.jpg -resize 200x200^ -gravity center -extent 200x200 avatar.jpg

# Circular avatar (PNG with transparency)
magick input.jpg -resize 200x200^ -gravity center -extent 200x200 \
  \( +clone -threshold -1 -negate -fill white -draw "circle 100,100 100,0" \) \
  -alpha off -compose copy_opacity -composite avatar.png

Responsive Images

bash

# Generate multiple sizes
for size in 320 640 1024 1920; do
  magick input.jpg -resize ${size}x -quality 85 "output-${size}w.jpg"
done

Watermarking

bash

# Bottom-right watermark
magick input.jpg watermark.png -gravity southeast \
  -geometry +10+10 -composite output.jpg

# Tiled watermark
magick input.jpg \( watermark.png -alpha set -channel A \
  -evaluate multiply 0.3 +channel \) -tile -composite output.jpg

Error Handling

Common issues and solutions:

File not found:

bash

# Check file exists
[ -f input.jpg ] && magick input.jpg output.png || echo "File not found"

Invalid geometry:

bash

# Validate dimensions first
identify -format "%wx%h" input.jpg

Memory errors:

bash

# Limit resources
magick -limit memory 1GB -limit map 2GB input.jpg output.png

Best Practices

Always use -strip to remove metadata (reduces file size)
Set appropriate quality (85 for JPEG is good balance)
Use +repage after crop to reset virtual canvas
Quote file paths with spaces: "my image.jpg"
Test on sample before batch processing
Backup originals when using mogrify
Use -auto-orient to respect EXIF orientation
Progressive JPEGs for web (use -interlace Plane)
Limit memory for large batches to prevent crashes
Check output after complex operations

Troubleshooting

Policy Restrictions

Some systems restrict ImageMagick operations for security:

bash

# Check policy
identify -list policy

# Edit policy file (if needed)
sudo nano /etc/ImageMagick-6/policy.xml
# or
sudo nano /etc/ImageMagick-7/policy.xml

Common Errors

"convert: not authorized"

ImageMagick security policy blocking operation
Edit policy.xml to allow specific formats/operations

"convert: no decode delegate"

Missing format support library
Install additional libraries (libjpeg, libpng, libwebp, etc.)

"convert: memory allocation failed"

Image too large or insufficient memory
Use -limit flags or process in smaller chunks

Resources

Official Documentation: https://imagemagick.org/
Command-line Options: https://imagemagick.org/script/command-line-options.php
Examples: https://imagemagick.org/Usage/
Format Support: https://imagemagick.org/script/formats.php

Command Reference Quick Guide

Format Conversion:

bash

magick input.ext output.ext

Resize:

bash

magick input.jpg -resize WIDTHxHEIGHT output.jpg

Crop:

bash

magick input.jpg -crop WIDTHxHEIGHT+X+Y output.jpg

Thumbnail:

bash

magick input.jpg -resize 100x100^ -gravity center -extent 100x100 thumb.jpg

Effects:

bash

magick input.jpg -blur 0x8 output.jpg

Batch:

bash

mogrify -resize 800x600 *.jpg

Info:

bash

identify -verbose image.jpg

Files

Just SKILL.md in claude/skills/imagemagick of einverne/dotfiles.

Open the folder on GitHubat commit c6c0686

Compare with similar skills

Imagemagick next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Imagemagick compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Imagemagick this skilleinverne/dotfiles	121	—	~3.8k	Automated safety check: Notes	MIT	1 mo ago
Guizang Social Cardsop7418/guizang-social-card-skill	7.4k	1 repos	~7.8k	Automated safety check: Pass	AGPL-3.0	3 mo ago
Weekly Changelog Videoheygen-com/hyperframes	59k	—	~3.3k	Automated safety check: Pass	Apache-2.0	today
Anthropic Brand Stylinganthropics/skills	180k	30 repos	~559	Automated safety check: Pass	Apache-2.0	today
MoneyPrinterTurbo Video Generatorharry0703/MoneyPrinterTurbo	129k	—	~2.1k	Automated safety check: Warn	MIT	today
Brag Slim Launch Video Makerlatent-spaces/brag	14k	1 repos	~1.9k	Automated safety check: Pass	MIT	3 days ago

Similar skills

Guizang Social Cards
op7418/guizang-social-card-skill
Produces social card sets for Xiaohongshu and WeChat: carousels, Live Photo motion cards and puzzle layouts, and WeChat cover pairs, rendered from single-file HTML.
7.4k GitHub starsUsed in 1 repo~7.8k tokens
Media & CreativeAuto-check passed
Weekly Changelog Video
heygen-com/hyperframes
Turns a weekly changelog markdown file into a branded HyperFrames video with voiceover, animated mock-UI scenes and captions, using fonts, background and scripts bundled in the skill.
59k GitHub stars~3.3k tokensUpdated today
Media & CreativeAuto-check passed
Anthropic Brand Styling
anthropics/skills
Official
Applies Anthropic's brand colors and fonts to artifacts such as PowerPoint slides, using fixed hex values for text and accents, Poppins headings and Lora body text.
180k GitHub starsUsed in 30 repos~559 tokens
Media & CreativeAuto-check passed
MoneyPrinterTurbo Video Generator
harry0703/MoneyPrinterTurbo
Installs and runs MoneyPrinterTurbo to turn a topic or script into a finished short video with voice-over, subtitles, stock footage and music.
129k GitHub stars~2.1k tokensUpdated today
Media & CreativeAuto-check: warnings
Brag Slim Launch Video Maker
latent-spaces/brag
Builds a short, shareable launch video with music and motion from a project directory or a website URL, using only tools already on the machine.
14k GitHub starsUsed in 1 repo~1.9k tokens
Media & CreativeAuto-check passed
HyperFrames Media Use
heygen-com/hyperframes
Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.
59k GitHub stars~2.4k tokensUpdated today
Media & CreativeAuto-check passed

Questions about Imagemagick

What does Imagemagick do?

Guide for using ImageMagick command-line tools to perform advanced image processing tasks including format conversion, resizing, cropping, effects, transformations, and batch operations. Imagemagick is an agent skill from einverne/dotfiles. Guide for using ImageMagick command-line tools to perform advanced image processing tasks including format conversion, resizing, cropping, effects, transformations, and batch operations.

When should I use Imagemagick?

Imagemagick fits situations like: manipulating images programmatically via shell commands.

How do I install Imagemagick in Claude Code?

Run `npx skills add einverne/dotfiles --skill imagemagick -a claude-code`. Or copy the skill folder (claude/skills/imagemagick in einverne/dotfiles) into .claude/skills/imagemagick in your project. Claude Code loads it when a task matches its description.

How do I install Imagemagick in Codex?

Run `npx skills add einverne/dotfiles --skill imagemagick -a codex`. Or copy the skill folder (claude/skills/imagemagick in einverne/dotfiles) into .agents/skills/imagemagick in your project. Codex loads it when a task matches its description.

Can I use Imagemagick in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add einverne/dotfiles --skill imagemagick -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/imagemagick, .gemini/skills/imagemagick, .github/skills/imagemagick and .opencode/skills/imagemagick in your project.

What does Imagemagick need to run?

Going by SKILL.md and its folder, Imagemagick needs the command-line tools its instructions call (magick, brew and apt-get).

Does Imagemagick access the network?

SKILL.md names 1 domain. As links in the text: imagemagick.org. This is read from the text; nothing was executed.

Is Imagemagick safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Imagemagick use?

Imagemagick is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Imagemagick use?

About 3.8k tokens (SKILL.md is roughly 15k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Imagemagick?

Skills that share tags, products or a category with Imagemagick: Guizang Social Cards (op7418/guizang-social-card-skill, 7.4k stars), Weekly Changelog Video (heygen-com/hyperframes, 59k stars), Anthropic Brand Styling (anthropics/skills, 180k stars) and MoneyPrinterTurbo Video Generator (harry0703/MoneyPrinterTurbo, 129k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Imagemagick?

einverne (a GitHub user) maintains it in einverne/dotfiles, which has 121 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on September 9, 2026.

Source: einverne/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Imagemagick

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

ImageMagick Skill

When to Use This Skill

Core Concepts

Primary Commands

Command Structure

Geometry Specifications

Installation

Common Operations

Format Conversion

Resizing

Cropping

Resize + Crop (Thumbnail Generation)

Effects and Filters

Adjustments

Rotation and Flipping

Borders and Frames

Text and Watermarks

Compositing

Format-Specific Options

Batch Processing

Using mogrify

Using shell loops

Image Information

Using identify

Common format strings

Advanced Techniques

Creating Contact Sheets

Animated GIFs

Complex Pipelines

Performance Optimization

Memory and Speed

Quality vs Size Trade-offs

Common Patterns

Avatar/Profile Picture Generation

Responsive Images

Watermarking

Error Handling

Best Practices

Troubleshooting

Policy Restrictions

Common Errors

Resources

Command Reference Quick Guide

Files

Compare with similar skills

Similar skills

More from einverne/dotfiles

Related

Questions about Imagemagick