/digital-marketing-pro:image-seo-audit
Purpose
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.
Input Required
- URL: Page or site to audit
- Scope: Single page or site-wide crawl (default: single page)
Process
- Load brand context: Read active brand profile for industry context.
- Discover images: Find all
<img>, <picture>, CSS background-image, and <source> elements.
- Alt text audit: Check presence, quality, keyword inclusion, length (10-125 chars). Flag: missing, filename-only ("image.jpg"), keyword-stuffed, non-descriptive ("click here").
- File size audit: Apply tiered thresholds by image category — thumbnails (<50KB target, >200KB critical), content images (<100KB target, >500KB critical), hero/banner (<200KB target, >700KB critical).
- Format audit: Check for modern formats. Recommend WebP (97%+ support) or AVIF (92%+ support) over JPEG/PNG. Check for
<picture> element with format fallbacks. Note: JPEG XL restored in Chromium (Nov 2025) but not yet in Chrome stable — monitor, don't recommend yet.
- Responsive images: Check for
srcset and sizes attributes, appropriate resolution for device pixel ratios.
- Lazy loading: Verify
loading="lazy" on below-fold images. Flag loading="lazy" on above-fold/hero images (directly harms LCP).
- fetchpriority: Check for
fetchpriority="high" on LCP/hero images. Check for decoding="async" on non-LCP images.
- CLS prevention: Check for
width and height attributes or aspect-ratio CSS on all <img> elements. Flag images without dimensions.
- File naming: Check for descriptive, hyphenated, lowercase file names vs generic names (IMG_1234.jpg).
- CDN usage: Check if images are served from a CDN (different domain, CDN headers, edge caching).
- Score and prioritize: Sort by file size savings impact (largest first).
Recommended Picture Element Pattern
<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>
Hero/LCP Image Pattern
<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.
Output
Image Audit Summary
| 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 |
Prioritized Optimization List
Sorted by estimated file size savings (largest first):
| Image |
Current Size |
Format |
Issues |
Est. Savings |
| hero.jpg |
450KB |
JPEG |
No WebP, no fetchpriority |
~300KB |
| ... |
... |
... |
... |
... |
Recommendations (prioritized)
- Convert X images to WebP format (est. XX KB total savings)
- Add alt text to X images
- Add width/height dimensions to X images
- Enable lazy loading on X below-fold images
- Add fetchpriority="high" to LCP image
- Compress X oversized images
- Implement
<picture> element with AVIF/WebP fallbacks
Agents Used
- seo-specialist — Image optimization analysis, CWV impact assessment
Scripts Used
- tech-seo-auditor.py — Fetch page and analyze image elements
Source: hashgraph-online/awesome-codex-plugins → plugins/indranilbanerjee/digital-marketing-pro/skills/image-seo-audit/SKILL.md
1---2name: image-seo-audit3description: Audit image SEO. Use when: checking alt text, file sizes, WebP/AVIF formats, lazy loading, or responsive images.4---567# /digital-marketing-pro:image-seo-audit89## Purpose1011Perform 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.1213## Input Required1415- **URL**: Page or site to audit16- **Scope**: Single page or site-wide crawl (default: single page)1718## Process19201. **Load brand context**: Read active brand profile for industry context.212. **Discover images**: Find all `<img>`, `<picture>`, CSS `background-image`, and `<source>` elements.223. **Alt text audit**: Check presence, quality, keyword inclusion, length (10-125 chars). Flag: missing, filename-only ("image.jpg"), keyword-stuffed, non-descriptive ("click here").234. **File size audit**: Apply tiered thresholds by image category — thumbnails (<50KB target, >200KB critical), content images (<100KB target, >500KB critical), hero/banner (<200KB target, >700KB critical).245. **Format audit**: Check for modern formats. Recommend WebP (97%+ support) or AVIF (92%+ support) over JPEG/PNG. Check for `<picture>` element with format fallbacks. Note: JPEG XL restored in Chromium (Nov 2025) but not yet in Chrome stable — monitor, don't recommend yet.256. **Responsive images**: Check for `srcset` and `sizes` attributes, appropriate resolution for device pixel ratios.267. **Lazy loading**: Verify `loading="lazy"` on below-fold images. Flag `loading="lazy"` on above-fold/hero images (directly harms LCP).278. **fetchpriority**: Check for `fetchpriority="high"` on LCP/hero images. Check for `decoding="async"` on non-LCP images.289. **CLS prevention**: Check for `width` and `height` attributes or `aspect-ratio` CSS on all `<img>` elements. Flag images without dimensions.2910. **File naming**: Check for descriptive, hyphenated, lowercase file names vs generic names (IMG_1234.jpg).3011. **CDN usage**: Check if images are served from a CDN (different domain, CDN headers, edge caching).3112. **Score and prioritize**: Sort by file size savings impact (largest first).3233## Recommended Picture Element Pattern3435```html36<picture>37 <source srcset="image.avif" type="image/avif">38 <source srcset="image.webp" type="image/webp">39 <img src="image.jpg" alt="Descriptive alt text" width="800" height="600" loading="lazy" decoding="async">40</picture>41```4243## Hero/LCP Image Pattern4445```html46<img src="hero.webp" fetchpriority="high" alt="Hero image description" width="1200" height="630">47```4849Do NOT lazy-load above-fold/LCP images. Do NOT add `decoding="async"` to LCP images.5051## Output5253### Image Audit Summary5455| Metric | Status | Count |56|--------|--------|-------|57| Total Images | — | XX |58| Missing Alt Text | issues | XX |59| Oversized (>200KB) | issues | XX |60| Wrong Format (not WebP/AVIF) | issues | XX |61| No Dimensions (CLS risk) | issues | XX |62| Not Lazy Loaded (below-fold) | issues | XX |63| No fetchpriority on LCP | issues | XX |6465### Prioritized Optimization List6667Sorted by estimated file size savings (largest first):6869| Image | Current Size | Format | Issues | Est. Savings |70|-------|-------------|--------|--------|-------------|71| hero.jpg | 450KB | JPEG | No WebP, no fetchpriority | ~300KB |72| ... | ... | ... | ... | ... |7374### Recommendations (prioritized)751. Convert X images to WebP format (est. XX KB total savings)762. Add alt text to X images773. Add width/height dimensions to X images784. Enable lazy loading on X below-fold images795. Add fetchpriority="high" to LCP image806. Compress X oversized images817. Implement `<picture>` element with AVIF/WebP fallbacks8283## Agents Used8485- **seo-specialist** — Image optimization analysis, CWV impact assessment8687## Scripts Used8889- **tech-seo-auditor.py** — Fetch page and analyze image elements9091---9293**Source:** [`hashgraph-online/awesome-codex-plugins`](https://github.com/hashgraph-online/awesome-codex-plugins) → `plugins/indranilbanerjee/digital-marketing-pro/skills/image-seo-audit/SKILL.md`
thedixitjain