image-seo

Audit images on AEM Edge Delivery Services pages for alt text, performance attributes, and SEO compliance.

1|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aemgdc/aemdev --skill image-seo-aemgdc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: image-seo
Source: https://github.com/aemgdc/aemdev/tree/main/.agents/skills/image-seo
Command: npx skills add https://github.com/aemgdc/aemdev --skill image-seo-aemgdc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Images on AEM Edge Delivery Services sites often ship with missing or poor alt text, lazy-loaded LCP images, missing dimensions, and non-descriptive filenames, hurting accessibility, Core Web Vitals, and image search rankings. This Skill audits every image on a page and produces prioritized fix instructions split between authors and developers. ## Core Features & Use Cases - Alt Text Audit: Checks every image for missing, empty, filename-based, generic, or poorly formatted alt text against WCAG 2.1 AA criteria, and suggests improved alt text. - Performance Audit: Detects lazy-loaded LCP images (P0 issue), missing width/height attributes causing CLS, and incorrect fetchpriority or loading attributes. - File Naming & Decorative Image Checks: Flags non-descriptive filenames and verifies decorative images use empty alt attributes. - Use Case: Before launching a new AEM site section, run the audit to get a per-page report listing which alt text fixes the content author must make in Google Docs or Word, and which loading/fetchpriority fixes the developer must make in block code. ## Quick Start Audit the images on https://www.example.com/landing-page for SEO and performance issues and give me a fix report.

Frequently Asked Questions about image-seo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit image alt text on an AEM Edge Delivery Services site?▼

Fetch the page's raw HTML with curl and inspect every img element's alt attribute against quality criteria like presence, length, descriptiveness, and filename usage. The audit produces suggested alt text and instructions for authors to fix it in Google Docs or Word image properties.

How do I fix a lazy-loaded LCP image in AEM EDS?▼

A lazy-loaded LCP image is a P0 performance issue. Set loading="eager" and fetchpriority="high" on the hero image in the block's JavaScript, such as hero.js, or adjust the eager/lazy logic in aem.js or lib-franklin.js.

Why can't I see image attributes when fetching an EDS page?▼

Tools that convert HTML to markdown strip alt, loading, fetchpriority, width, and height attributes. Use curl to fetch raw HTML so all image attributes remain visible for the audit.

Who fixes image alt text in AEM Edge Delivery Services, authors or developers?▼

Alt text is an author responsibility in EDS. It is set in the source document via Google Docs (right-click image, Alt text) or Word (Edit Alt Text). Developers cannot set alt text for content images in code.

Does this audit handle image compression or format conversion?▼

No. Image optimization is handled automatically by the EDS CDN, which converts images to WebP, resizes them, and serves responsive variants. The audit focuses on alt text, loading behavior, dimensions, and naming instead.

When should decorative images have empty alt text?▼

Purely decorative images like dividers, spacers, and background patterns should have alt="" so screen readers skip them. Content images that convey information must never have empty alt text, as that is a WCAG 2.1 AA failure.