Tortuga
image-check

image-check

Scan your codebase for oversized images and convert them to WebP

Author

Tortuga

Launch Date

March 2026

Platforms
Claude Code Claude Code
Est. Token Cost

~100 tokens

View on GitHub

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