/seo-image-audit

name: seo-image-audit
description: Audit a page's images for SEO and performance — alt text, file size, modern formats (WebP/AVIF), responsive srcset, lazy loading, and CLS-safe dimensions, plus ready-to-run conversion commands. Uses DataForSEO for live image-SERP rankings when connected; otherwise audits from page fetch and parsing alone. Trigger when the user says "image seo", "image audit", "alt text", "image optimization", "convert to webp", "convert to avif", or "image performance".

seo-image-audit

**Family:** seo **Status:** Stable

Purpose

The audit half of image SEO (split from generation because the two have different legal, asset, and API risk). Inventories a page's images and scores each on the dimensions that affect search and performance. The free path (fetch + parse) is the whole product; DataForSEO only adds live image-SERP context.

Triggers

• "image seo" / "image audit" / "image optimization"
• "alt text" / "image metadata"
• "convert to webp" / "convert to avif"
• "image rankings" / "google images"

Inputs

• Page URL or local HTML/build path (or an image directory)
• Optional: target keyword(s) for alt-text relevance

Steps

1. **Inventory images** — fetch the page (or scan the directory) and list every image with its `src`, dimensions, format, and file size. 2. **Score each image:**

• **Alt text** — present? descriptive? keyword-relevant without stuffing?

(decorative images should have empty `alt=""`).

• **Format** — modern (WebP/AVIF) vs legacy (JPEG/PNG); flag conversion wins.
• **File size / dimensions** — oversized for display size? recommend target.
• **Responsive** — `srcset`/`sizes`/`<picture>` present where useful?
• **Lazy loading** — `loading="lazy"` below the fold; eager for the LCP image.
• **CLS** — width/height or aspect-ratio declared to reserve space?

3. **Optional enrichment** — if the DataForSEO extension is configured, add image SERP rankings; otherwise state, in one line, what it would add. 4. **Render findings** grouped Critical / High / Medium / Low, each with a concrete fix and (for format/size) the recommended target. For "convert to webp/avif" requests, output ready-to-run conversion commands per image (`cwebp`, ImageMagick `magick`, or a Sharp snippet) as the actionable deliverable — running them needs that tool installed (see Notes).

Outputs

• Per-image findings table with prioritized fixes
• A summary of the biggest performance wins (format + size)
• A short "what paid data would add" note on the free path

Dependencies

• None required — the free path uses page fetch + parsing
• Optional: DataForSEO extension (image SERP); `seo-page` (page-level context)

Notes

Pairs with `seo-image-gen` (the generation half). Actual file conversion (WebP/AVIF) and metadata injection require Sharp/ImageMagick if you want the skill to perform the conversion rather than recommend it.