image-seo-audit
Skill0 starsChanged 9 months agoMITView on GitHub
Audit every image on a page for SEO, performance, and accessibility — alt text quality, tiered file-size thresholds, WebP/AVIF format adoption, srcset/sizes responsiveness, lazy loading, fetchpriority on the LCP image, and width/height for CLS — producing an optimization list sorted by file-size savings. Triggers on \"/digital-marketing-pro:image-seo-audit\", \"audit our image SEO\", \"check alt text across the page\", \"why are our images so heavy\", \"should we switch to WebP\". Fetches and analyzes the page via tech-seo-auditor.py and reads the brand profile for industry context.
2 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- JakeLabate/Claude-SEO-Skillstheir own version, first seen Nov 16, 2026
- indranilbanerjee/digital-marketing-proedited, first seen Feb 12, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 1
- indranilbanerjee/digital-marketing-pro★ 93485% same
Wrote their own version · 1
- JakeLabate/Claude-SEO-Skills★ 3same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository163 other files it gives its agents.
- AGENTS.mdAGENTS.md
- ab-test-planSkill
- ad-creativeSkill
- add-integrationSkill
- aeo-auditSkill
- aeo-geoSkill
- agency-dashboardSkill
- analytics-insightsSkill
- anomaly-scanSkill
- attribution-modelSkill
- attribution-reportSkill
- audience-intelligenceSkill
- audience-profileSkill
- autopilot-statusSkill
- backlink-gapSkill
- brand-setupSkill
- budget-optimizerSkill
- budget-trackerSkill
- c2pa-metadataSkill
- campaign-auditSkill
- campaign-orchestratorSkill
- campaign-planSkill
- campaign-statusSkill
- case-study-planSkill
- checkSkill
- churn-riskSkill
- client-onboardingSkill
- client-proposalSkill
- client-reportSkill
- client-validation-documentSkill
- cohort-analysisSkill
- competitor-alertsSkill
- competitor-analysisSkill
- competitor-monitorSkill
- competitor-pagesSkill
- connectSkill
- content-briefSkill
- content-calendarSkill
- content-decay-scanSkill
- content-engineSkill
- content-repurposeSkill
- context-engineSkill
- continuous-improvement-loopSkill
- counter-narrativeSkill
- cowork-setupSkill
- creative-healthSkill
- creative-testing-frameworkSkill
- credential-switchSkill
- crisis-responseSkill
- crm-syncSkill
- croSkill
- dark-funnelSkill
- data-exportSkill
- data-importSkill
- digital-prSkill
- email-sequenceSkill
- emerging-channelsSkill
- engagement-workflowSkill
- entity-auditSkill
- eval-configSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. About 0 are common, 6 are distinctive, and 7 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
7
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 21
Load brand context: Read active brand profile for industry context.
- Distinctive: line 23
Alt text audit: Check presence, quality, keyword inclusion, length (10-125 chars).
- Very specific: line 25
Format audit: Check for modern formats. Recommend WebP (97%+ support) or AVIF (92%+ support) over JPEG/PNG.
- Very specific: line 26
Responsive images: Check for srcset and sizes attributes, appropriate resolution for device pixel ratios.
- Very specific: line 27
Lazy loading: Verify loading="lazy" on below-fold images.
- Very specific: line 28
fetchpriority: Check for fetchpriority="high" on LCP/hero images.
- Very specific: line 29
CLS prevention: Check for width and height attributes or aspect-ratio CSS on all <img> elements.
- Very specific: line 30
File naming: Check for descriptive, hyphenated, lowercase file names vs generic names (IMG_1234.jpg).
- Distinctive: line 31
CDN usage: Check if images are served from a CDN (different domain, CDN headers, edge caching).
- Very specific: line 50
Do NOT lazy-load above-fold/LCP images.
- Distinctive: line 77
Add alt text to X images
- Distinctive: line 78
Add width/height dimensions to X images
- Distinctive: line 80
Add fetchpriority="high" to LCP image
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
/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>, CSSbackground-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
srcsetandsizesattributes, appropriate resolution for device pixel ratios. - Lazy loading: Verify
loading="lazy"on below-fold images. Flagloading="lazy"on above-fold/hero images (directly harms LCP). - fetchpriority: Check for
fetchpriority="high"on LCP/hero images. Check fordecoding="async"on non-LCP images. - CLS prevention: Check for
widthandheightattributes oraspect-ratioCSS 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
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

