# image-edit

image-edit is a Claude Code skill that resizes, crops, converts and compresses images. It activates for requests to edit a single image or process a folder in bulk.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 285 repo stars
- Author: makushingu
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/makushingu/harness-maxxing/tree/HEAD/skills/image-edit/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/makushingu-image-edit

## What it does

image-edit runs ImageMagick and ffmpeg commands to modify images. It can change dimensions or formats, crop and compress files, add borders or text, and create thumbnails or contact sheets. It can also remove metadata and extract a frame from a video.

By default, output goes to a new file or an `out/` folder, leaving the source untouched. ImageMagick and ffmpeg are required. Ubuntu and Debian systems with ImageMagick 6 use `convert`, `montage` and `identify`; version 7 uses `magick`, `magick montage` and `magick identify`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill image-edit -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/image-edit/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/image-edit/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill image-edit -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/image-edit/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill image-edit -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/image-edit/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install makushingu/harness-maxxing skills/image-edit
```

2. **Manually: put the files in place**
- File: `.github/skills/image-edit/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill image-edit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/makushingu/harness-maxxing --path skills/image-edit
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/image-edit/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/makushingu/harness-maxxing/tree/HEAD/skills/image-edit/SKILL.md

## When to use it
- resize an image while keeping its proportions
- convert and compress images for the web
- make thumbnails or a contact sheet from a folder
- remove image metadata
- extract a frame from a video

## Example prompts
- Convert `banner.png` to a compressed `banner.webp`.
- Create a square thumbnail from `photo.jpg`.
- Make a contact sheet from the JPG files in this folder.

## Similar
- [gpt-image-edit](https://affpapa.org/en/nevibecode/skills/gpt-image-edit.md) — skill · 447000 installs
- [fal-image-edit](https://affpapa.org/en/nevibecode/skills/fal-image-edit.md) — skill · 2900 installs
- [eachlabs-image-edit](https://affpapa.org/en/nevibecode/skills/eachlabs-image-edit.md) — skill · 807 installs
- [venice-image-edit](https://affpapa.org/en/nevibecode/skills/veniceai-venice-image-edit.md) — skill · ★ 176 repo stars
- [edit-image](https://affpapa.org/en/nevibecode/skills/edit-image.md) — skill · ★ 195 repo stars
- [video-edit](https://affpapa.org/en/nevibecode/skills/video-edit.md) — skill · 450700 installs

## Other versions with the same name
- [image-edit · prime-skills](https://affpapa.org/en/nevibecode/skills/image-edit.md) — 448100 installs

From the same set: [makushingu/harness-maxxing](https://affpapa.org/en/nevibecode/by/makushingu/harness-maxxing.md) — 21 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
