image-check skill for Claude Code

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, which gives you a clear picture of the performance win