Skip to content

Image SEO Auditor

Audits web images for alt text, file size, format, lazy loading and layout shift, and can convert files to WebP/AVIF.

Stars
25,798
Licence
MIT
Files
2 files

What it does

Once installed, the agent checks the images on a web page or site against SEO and performance rules: whether each image has descriptive alt text, whether files are too large for their role, whether modern formats like WebP or AVIF are used, whether width and height are set to prevent layout jumps, and whether lazy loading is applied correctly. It then returns a prioritized list of fixes with estimated savings. The skill also describes optional steps such as image search ranking checks through DataForSEO and metadata injection or format conversion for image files.

Great for

  • Website owners or SEO specialists who want a checklist of image problems slowing a page or hurting search visibility
  • Front-end developers tuning Largest Contentful Paint and layout shift on image-heavy pages
  • WordPress or static-site maintainers preparing a batch of images for conversion to WebP or AVIF

Skip it if

  • Sites where you cannot share or fetch page content: the checks depend on the page HTML and image files being accessible, so they will be incomplete without them.
  • Anyone expecting guaranteed search ranking gains: the rules are general best practice and the skill does not measure actual results.
  • Batch conversion or metadata edits on original master files without a backup: the skill describes WebP/AVIF conversion and IPTC/XMP metadata injection, which change files and could lose information if run carelessly.

Try asking

  • “Audit the images on https://example.com/blog and list missing alt text and oversized files.”
  • “Convert the product photos in this folder to WebP and tell me the estimated savings.”
  • “Check whether my hero image should use fetchpriority and whether lazy loading is hurting it.”
  • “Show me which images on this page lack width and height attributes and how to fix them.”
Step-by-step guide: how to use Image SEO AuditorInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    seo-images.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip seo-images.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip seo-images.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give a specific URL so the audit covers real page markup rather than guesses; back up original images before asking for conversion or metadata changes.
  • Ask for the prioritized optimization list first, then request fixes one category at a time.
  • Verify browser support figures and the emerging JPEG XL note against current sources before quoting them to a client, since the file itself says they should be re-checked.

What's inside

  • LICENSE.txt
  • SKILL.md

Redistributed unmodified from AgriciDaniel/claude-seo under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.