Skip to main content
skill CX Codex

imagemagick-conversion — Claude Code skill

imagemagick-conversion — a skill for converting, resizing and optimizing images via ImageMagick command-line. Useful for bulk format conversion, thumbnail generation, and large-scale image processing workflows.

MIT 260 installs ★ 60 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add laurigates/claude-plugins --skill imagemagick-conversion -a claude-code
Open on GitHub

What imagemagick-conversion does

This skill wraps the magick command and lets your agent handle common image tasks: change format (PNG, JPEG, WebP, GIF, TIFF), scale by dimension or percentage, compress with quality control, create thumbnails. It includes ready-made patterns for batch operations, web optimization, and multi-format export.

ImageMagick must be installed and the magick command available in PATH. The skill uses bash commands and Glob file discovery, so it runs in CLI environments (Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode).

Core syntax: magick input [flags] output. The skill handles quality settings (-quality), resize modes (-resize), conditional scaling (> and <), fast thumbnails (-thumbnail), and metadata stripping (-strip). For batch work, mogrify with -path preserves originals while writing results to a new directory.

What it helps with

  • convert hundreds of photos from JPEG to WebP at a specific quality level
  • generate a set of uniform thumbnails with exact dimensions and white padding
  • reduce an image by 50 percent while preserving aspect ratio
  • optimize PNG files for the web by removing metadata
  • export one source image to multiple formats (PNG, WebP, JPEG)

Example prompts for the agent

  • Convert all JPG files in the current folder to WebP at quality 85 and save to output/
  • Generate 300x300 thumbnails for every image in images/ and put them in thumbnails/
  • Resize photo.jpg to half its size and save as photo-small.jpg

How to install imagemagick-conversion

1Skills CLI (Vercel)

npx skills add laurigates/claude-plugins --skill imagemagick-conversion -a claude-code

2Manually: put the files in place

~/.claude/skills/imagemagick-conversion/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/imagemagick-conversion/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about imagemagick-conversion

How do I install imagemagick-conversion in Claude Code?

Run npx skills add laurigates/claude-plugins --skill imagemagick-conversion -a claude-code in the terminal, then check the setup guide at ~/.claude/skills/imagemagick-conversion/SKILL.md.

What does imagemagick-conversion do?

The skill lets your agent use ImageMagick from the command line: convert between formats, resize images, compress with quality control, generate thumbnails, and batch-process multiple files.

What do I need to use this skill?

ImageMagick must be installed on your system with the magick command in PATH. The skill runs in CLI environments (Claude Code, Codex, Cursor, etc.) and requires bash plus file utilities (Read, Grep, Glob).

Source text

SKILL.md · MIT
---
created: 2025-12-16
modified: 2026-11-13
reviewed: 2025-12-16
name: imagemagick-conversion
description: "ImageMagick image manipulation: format conversion, resizing, batch processing, quality. Use when converting, resizing, batch-processing, or generating thumbnails."
user-invocable: false
allowed-tools: Bash(magick *), Bash(mkdir *), Bash(basename *), Read, Grep, Glob
model: sonnet
---

# ImageMagick Image Conversion

**Project:** Project-independent
**Gitignored:** Yes

## Trigger

Use this skill when users request image manipulation tasks including:
- Converting between image formats (PNG, JPEG, WebP, GIF, TIFF, etc.)
- Resizing images (dimensions, percentages, aspect ratios)
- Batch processing multiple images
- Adjusting image quality and compression
- Creating thumbnails
- Basic image transformations (rotate, flip, crop)

## Overview

ImageMagick is a powerful command-line tool for image processing. This skill provides guidance for using the `magick` command to perform common image conversion and manipulation tasks.

**Key Command Pattern:**
```bash
magick input-file [options] output-file
```

## Common Use Cases

### Format Conversion

**Basic format conversion:**
```bash
magick image.jpg image.png
magick photo.png photo.webp
```

**Batch convert all JPEGs to PNG:**
```bash
magick mogrify -format png *.jpg
```

**Convert with specific output directory:**
```bash
mkdir -p output
magick mogrify -format webp -path output/ *.jpg
```

### Resizing Images

**Resize by percentage:**
```bash
magick image.jpg -resize 50% output.jpg
```

**Resize to specific width (maintain aspect ratio):**
```bash
magick image.jpg -resize 800x output.jpg
```

**Resize to specific height (maintain aspect ratio):**
```bash
magick image.jpg -resize x600 output.jpg
```

**Resize to fit within dimensions (maintain aspect ratio):**
```bash
magick image.jpg -resize 800x600 output.jpg
```

**Resize to exact dimensions (ignore aspect ratio):**
```bash
magick image.jpg -resize 800x600! output.jpg
```

**Resize only if larger:**
```bash
magick image.jpg -resize '800x600>' output.jpg
```

**Resize only if smaller:**
```bash
magick image.jpg -resize '800x600<' output.jpg
```

### Quality and Compression

**Set JPEG quality (1-100, default 92):**
```bash
magick image.jpg -quality 85 output.jpg
```

**Optimize PNG compression:**
```bash
magick image.png -quality 95 output.png
```

**Create high-quality WebP:**
```bash
magick image.jpg -quality 90 output.webp
```

### Thumbnails

**Generate thumbnail (fast, lower quality):**
```bash
magick image.jpg -thumbnail 200x200 thumb.jpg
```

**Generate thumbnail with padding:**
```bash
magick image.jpg -thumbnail 200x200 -background white -gravity center -extent 200x200 thumb.jpg
```

### Batch Operations

**Resize all images in directory:**
```bash
magick mogrify -resize 800x600 -path resized/ *.jpg
```

**Convert and resize in one operation:**
```bash
magick mogrify -resize 1200x -format webp -quality 85 -path output/ *.jpg
```

**Process specific file types:**
```bash
magick mogrify -resize 50% -path smaller/ *.{jpg,png,gif}
```

### Image Information

**Display image information:**
```bash
magick identify image.jpg
```

**Detailed image information:**
```bash
magick identify -verbose image.jpg
```

### Advanced Transformations

**Rotate image:**
```bash
magick image.jpg -rotate 90 rotated.jpg
```

**Flip horizontally:**
```bash
magick image.jpg -flop flipped.jpg
```

**Flip vertically:**
```bash
magick image.jpg -flip flipped.jpg
```

**Crop to specific region:**
```bash
magick image.jpg -crop 800x600+100+100 cropped.jpg
```

**Auto-orient based on EXIF:**
```bash
magick image.jpg -auto-orient output.jpg
```

**Strip metadata (reduce file size):**
```bash
magick image.jpg -strip output.jpg
```

## Important Notes

### mogrify vs convert

- **`magick mogrify`**: Modifies files in-place or writes to specified path
  - Use `-path` option to preserve originals
  - Efficient for batch operations

- **`magick convert`** (or just `magick`): Creates new files
  - Always preserves original
  - Better for single-file operations

### Performance Tips

1. **Use `-thumbnail` for thumbnails**: Faster than `-resize` for small previews
2. **Use `-strip` to remove metadata**: Reduces file size significantly
3. **Batch operations**: Process multiple files in one `mogrify` command
4. **Quality settings**: 85-90 is usually optimal for JPEG (balances size/quality)

### Format Recommendations

- **JPEG**: Photos, complex images with gradients (lossy)
- **PNG**: Screenshots, graphics with transparency (lossless)
- **WebP**: Modern format, excellent compression (lossy or lossless)
- **GIF**: Simple animations, limited colors
- **TIFF**: Archival, high-quality storage

## Safety Considerations

**Always test commands on copies first:**
```bash
# Create test directory
mkdir -p test-output

# Test on single file
magick original.jpg -resize 50% test-output/test.jpg

# Verify result before batch processing
```

**Use `-path` with mogrify to preserve originals:**
```bash
# This preserves originals in current directory
magick mogrify -resize 800x -path resized/ *.jpg
```

**Quote wildcards in shell:**
```bash
# Prevents premature shell expansion
magick mogrify -resize '800x600>' -path output/ '*.jpg'
```

## Common Patterns

### Web Optimization Workflow

```bash
# Create optimized versions for web
mkdir -p web-optimized

# Convert to WebP with quality 85, resize to max 1920px width
magick mogrify -resize 1920x -quality 85 -format webp -path web-optimized/ *.jpg

# Strip metadata to reduce size
magick mogrify -strip web-optimized/*.webp
```

### Thumbnail Generation

```bash
# Create thumbnail directory
mkdir -p thumbnails

# Generate 300x300 thumbnails with white padding
for img in *.jpg; do
  magick "$img" -thumbnail 300x300 -background white -gravity center -extent 300x300 "thumbnails/${img%.jpg}_thumb.jpg"
done
```

### Multi-Format Export

```bash
# Export to multiple formats for compatibility
mkdir -p exports/{png,webp,jpg}

for img in source/*.png; do
  name=$(basename "$img" .png)
  magick "$img" -quality 90 "exports/png/$name.png"
  magick "$img" -quality 85 "exports/webp/$name.webp"
  magick "$img" -quality 85 "exports/jpg/$name.jpg"
done
```

## Troubleshooting

**Check ImageMagick version:**
```bash
magick -version
```

**Verify supported formats:**
```bash
magick identify -list format
```

**Test command on single file first:**
```bash
# Always test before batch operations
magick test-image.jpg -resize 50% test-output.jpg
```

## When to Use This Skill

| Use this skill when... | Use other skills instead when... |
|---|---|
| Converting an image between standard formats (PNG/JPG/WebP/AVIF/GIF/HEIC) | Producing a brand-new image from a text prompt — use `generate-image` |
| Resizing, compressing, or adjusting quality of an existing image | Generating a repository social preview — use `github-actions-plugin:github-social-preview` |
| Running batch processing or thumbnail generation across many files | Advanced photo editing or complex filters (use GIMP, Photoshop, or dedicated tools) |
| Performing basic transformations (rotate, crop, flip) at scale | Video processing (use FFmpeg) or vector graphics (use Inkscape) |

## Integration with Workflows

This skill complements other development workflows:
- **Web development**: Optimize images for deployment
- **Documentation**: Generate screenshots and diagrams
- **CI/CD**: Automate image processing in pipelines
- **Content creation**: Prepare images for various platforms

The `magick` command is typically available via Homebrew (`brew install imagemagick`) or system package managers.

© laurigates · MIT · laurigates/claude-plugins

Similar skills

All skills for DevOps and infrastructure →

From the same set27

The whole set →
python-packaging python-packaging guides the agent through building wheels and sdists with uv, configuring pyproject.toml, and uploading packages to PyPI or Test PyPI. CX Codex +1 336installs uv-python-versions uv-python-versions is a Claude Code skill for managing CPython and PyPy with uv. Install interpreters, pin a project version, or switch versions for testing. CX Codex +1 332installs uv-advanced-dependencies uv-advanced-dependencies is a skill for managing non-standard dependency sources in uv, including GitHub repositories, editable local packages, and private indexes. It covers projects that need Git, local path, or custom index dependencies. CX Codex +1 332installs uv-tool-management uv-tool-management is a Claude Code skill for managing global Python CLI tools with uv and running them temporarily with uvx, including as an alternative to pipx. CX Codex +1 328installs jq-json-processing jq-json-processing — a skill for parsing, filtering and transforming JSON with jq. Extracts fields, filters arrays, reshapes objects and validates syntax. CX Codex +1 245installs python-development python-development gives your agent Python 3.10+ idioms: type hints, pattern matching, asyncio. Handy for library code and refactors. CX Codex +1 192installs generate-image The generate-image skill generates images from text prompts using Google's Gemini 3 Pro Image model on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. CX Codex +1 177installs justfile-expert justfile-expert is a Claude Code skill for designing Just recipes, parameters, dependencies, and modules. It supports adding project commands and task automation. CX Codex +1 162installs

Project sponsors

Companies that keep this analytics open