meowgorithm/image-convert
crush/skills/image-convert/SKILL.md
Convert images between formats (PNG, JPEG, WebP, GIF, BMP, TIFF, AVIF, HEIC) with quality control and resizing. Use when the user needs to convert images, batch process multiple files, optimize image sizes, or convert to modern formats like WebP or AVIF.
$ install --global
skillsauthnpx skillsauth add meowgorithm/dotfiles image-convertInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 30, 2026, 7:01 AM41.2s2 files scanned
SKILL.md
- name:
- image-convert
- description:
- Convert images between formats (PNG, JPEG, WebP, GIF, BMP, TIFF, AVIF, HEIC) with quality control and resizing. Use when the user needs to convert images, batch process multiple files, optimize image sizes, or convert to modern formats like WebP or AVIF.
Image Convert
Convert images between formats with quality control, resizing, and batch processing support.
Supported Formats
| Format | Extension | Notes | | ------ | ------------ | ------------------------------------ | | PNG | .png | Lossless, supports transparency | | JPEG | .jpg, .jpeg | Lossy compression, no transparency | | WebP | .webp | Modern format, good compression | | GIF | .gif | Animation support (first frame only) | | BMP | .bmp | Uncompressed, large files | | TIFF | .tiff, .tif | High quality, large files | | AVIF | .avif | Next-gen format, best compression | | HEIC | .heic, .heif | Apple format |
Quick Start
Single File Conversion
Convert by specifying output extension:
scripts/convert.sh input.png output.jpg
Or specify format explicitly:
scripts/convert.sh -f webp input.png output.webp
With Quality and Resize
# Convert to JPEG with 90% quality and resize to 1920px width
scripts/convert.sh -f jpg -q 90 -r 1920x input.png output.jpg
# Convert to WebP at 50% of original size
scripts/convert.sh -f webp -q 85 -r 50% input.png output.webp
Batch Conversion
Convert all PNG files to WebP:
scripts/convert.sh -f webp *.png
Output files will have the same basename with the new extension.
Command Options
| Option | Description | Example |
| --------------- | --------------------------- | ---------------------- |
| -f, --format | Output format | -f webp |
| -q, --quality | Quality 1-100 (default: 85) | -q 90 |
| -r, --resize | Resize geometry | -r 800x600, -r 50% |
| -v, --verbose | Show conversion commands | -v |
| -h, --help | Show help | -h |
Resize Geometry
| Syntax | Description | Example |
| ------ | ------------------------------- | --------- |
| WxH | Exact dimensions (may crop) | 800x600 |
| Wx | Width only, height proportional | 1920x |
| xH | Height only, width proportional | x1080 |
| W% | Percentage of original | 50% |
Tool Dependencies
The script uses available tools in this priority:
- ImageMagick (
magickorconvert): Primary tool for all formats- Prefers
magick(ImageMagick 7+) - Falls back to
convert(legacy ImageMagick 6) if needed
- Prefers
- cwebp/dwebp: Optimized WebP conversion when available
- sips (macOS): Can be used as fallback on macOS
Install ImageMagick for full functionality:
# macOS
brew install imagemagick webp
# Ubuntu/Debian
sudo apt-get install imagemagick webp
# Arch
sudo pacman -S imagemagick libwebp
Common Workflows
Optimize Images for Web
Convert to WebP with good quality and reasonable size:
scripts/convert.sh -f webp -q 80 -r 1200x *.png
Create Thumbnails
Generate 300px wide thumbnails:
for img in *.jpg; do
scripts/convert.sh -f jpg -q 75 -r 300x "$img" "thumbs/$img"
done
Convert HEIC to JPEG
scripts/convert.sh -f jpg -q 95 IMG_1234.HEIC output.jpg
PNG to Lossy for Smaller Size
scripts/convert.sh -f webp -q 85 large.png small.webp
Related Skills
- Video → animated WebP: Use the
video-to-webpskill. It handles fps, trimming, looping, and scaling with ffmpeg +img2webp.
Tips
- WebP: Best for web - 25-35% smaller than JPEG with same quality
- AVIF: Best compression but slower encoding, limited support
- PNG: Use for graphics with transparency or when lossless is required
- JPEG: Good for photos when WebP/AVIF aren't options
- Quality 80-85: Good balance of size and quality
- Quality 90-95: High quality for important images
- Quality 60-75: Acceptable for thumbnails/previews
Related Skills
meowgorithm/video-to-webp
tools
VerifiedTrustedCommunity
Convert video files (MP4, MOV, WebM, GIF, MKV, AVI, etc.) into animated WebP images with control over fps, size, quality, loop count, and trimming. Use when the user wants to turn a video or screen recording into an animated WebP, create a lightweight demo loop, replace an animated GIF with a smaller WebP, or produce a short clip as a .webp.
36SKILL.mdUpdated Apr 30, 2026
meowgorithm/charmtone
tools
VerifiedTrustedCommunity
Use charmtone colors via the `charmtone` CLI or Go API (`github.com/charmbracelet/x/exp/charmtone`). Triggers when the user asks to use charmtone colors, generate color palettes, get hex values, create CSS/SCSS/Vim color variables, or work with the CharmTone palette in Go code. Also triggers on mentions of specific charmtone color names (Cherry, Charple, Julep, Hazy, etc.) or requests to pick/choose/apply charmtone colors.
35SKILL.mdUpdated May 25, 2026
meowgorithm/commit
testing
VerifiedTrustedCommunity
Stage and commit changes with a Conventional Commits message. Invoke with /commit "optional scope hint". Inspects the diff, picks an appropriate type and scope, writes a concise message, and commits. Does not push.
35SKILL.mdUpdated May 21, 2026
meowgorithm/nix-profile
tools
VerifiedTrustedCommunity
Manage Nix profiles using the modern `nix profile` command (experimental, replaces `nix-env`). Use when installing, removing, upgrading, or managing packages with Nix flakes.
35SKILL.mdUpdated Apr 16, 2026