indranilbanerjee/image-seo-audit
Audit image SEO. Use when: checking alt text, file sizes, WebP/AVIF formats, lazy loading, or responsive images.
npx skills add https://github.com/indranilbanerjee/digital-marketing-pro --skill image-seo-audit
Perform a dedicated image optimization audit that evaluates all images on a page or site for SEO, performance, and accessibility. Produces a prioritized optimization list sorted by file size impact.
<img>, <picture>, CSS background-image, and <source> elements.<picture> element with format fallbacks. Note: JPEG XL restored in Chromium (Nov 2025) but not yet in Chrome stable — monitor, don't recommend yet.srcset and sizes attributes, appropriate resolution for device pixel ratios.loading="lazy" on below-fold images. Flag loading="lazy" on above-fold/hero images (directly harms LCP).fetchpriority="high" on LCP/hero images. Check for decoding="async" on non-LCP images.width and height attributes or aspect-ratio CSS on all <img> elements. Flag images without dimensions.10. File naming: Check for descriptive, hyphenated, lowercase file names vs generic names (IMG_1234.jpg).
11. CDN usage: Check if images are served from a CDN (different domain, CDN headers, edge caching).
12. Score and prioritize: Sort by file size savings impact (largest first).
<picture>
<source srcset="image.avif" type="image/avif">
<source srcset="image.webp" type="image/webp">
<img src="image.jpg" alt="Descriptive alt text" width="800" height="600" loading="lazy" decoding="async">
</picture>
<img src="hero.webp" fetchpriority="high" alt="Hero image description" width="1200" height="630">
Do NOT lazy-load above-fold/LCP images. Do NOT add decoding="async" to LCP images.
| Metric | Status | Count |
|--------|--------|-------|
| Total Images | — | XX |
| Missing Alt Text | issues | XX |
| Oversized (>200KB) | issues | XX |
| Wrong Format (not WebP/AVIF) | issues | XX |
| No Dimensions (CLS risk) | issues | XX |
| Not Lazy Loaded (below-fold) | issues | XX |
| No fetchpriority on LCP | issues | XX |
Sorted by estimated file size savings (largest first):
| Image | Current Size | Format | Issues | Est. Savings |
|-------|-------------|--------|--------|-------------|
| hero.jpg | 450KB | JPEG | No WebP, no fetchpriority | ~300KB |
| ... | ... | ... | ... | ... |
<picture> element with AVIF/WebP fallbacksTake indranilbanerjee/image-seo-audit from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.