image-check
Scan your codebase for oversized images and convert them to WebP
- Author
-
Tortuga
- Launch Date
-
March 2026
- Platforms
-
Claude Code
- Est. Token Cost
-
~100 tokens
Install
Copy and paste this into your terminal
$ npx skills add https://github.com/tortuga-ai/skills --skill tortuga:image-check About
Large images are one of the most common performance killers in web projects, and they're easy to miss until you're staring at a Lighthouse score. This skill finds every image in your codebase, reports file sizes, flags anything over 200 KB, and offers to convert them to WebP using cwebp or ffmpeg — whichever you have installed. Converts in place, shows before/after savings, and asks before deleting originals.
How It's Used
Run it any time you want a quick image audit — before a launch, after adding a batch of assets, or when Lighthouse flags image sizes. It scans the full project tree (skipping node_modules, dist, .git), prints a sorted table of all images with size and status, then walks you through converting and optionally deleting the originals.
What You Get
Image size report — Sorted table of every image in the project with file size and status — oversized images flagged with a warning, WebP/AVIF files noted, everything under 200 KB marked OK
WebP conversion — Converts flagged images to WebP using cwebp (preferred) or ffmpeg, reporting exact before/after sizes and percentage savings for each file
Savings summary — Final report showing total images, total size before and after, and overall bytes saved — gives you a clear picture of the performance win