Runs a full image SEO audit on any URL, checking alt text quality, file sizes against tiered thresholds (thumbnails under 50KB, hero images under 200KB), modern format usage (WebP/AVIF), responsive images, lazy loading, and CLS prevention with width/height attributes. It catches common mistakes like lazy loading LCP images or keyword-stuffed alt text. If you have the DataForSEO MCP installed, it also pulls Google Images SERP data to show which domains own image rankings for your keywords and where you have page rankings but missing image presence. The optimization recommendations are sorted by potential file size savings, which is the right way to prioritize. Good for content-heavy sites where image performance actually matters for Core Web Vitals.

skills.sh installs
7.5K
GitHub stars
27.8K
last updated
Aug 21, 2026

Install

$ npx -y skills add agricidaniel/claude-seo --skill seo-images --agent claude-code

Installs into .claude/skills of the current project.

Files

Image Optimization Analysis

Checks

Alt Text

  • Present on all <img> elements (except decorative: role="presentation"). parse_html.py marks these with decorative: true; do not flag them for missing alt text.
  • Descriptive: describes the image content, not "image.jpg" or "photo"
  • Includes relevant keywords where natural, not keyword-stuffed
  • Length: 10-125 characters

Good examples:

  • "Professional plumber repairing kitchen sink faucet"
  • "Red 2024 Toyota Camry sedan front view"
  • "Team meeting in modern office conference room"

Bad examples:

  • "image.jpg" (filename, not description)
  • "plumber plumbing plumber services" (keyword stuffing)
  • "Click here" (not descriptive)

File Size

Tiered thresholds by image category:

Image CategoryTargetWarningCritical
Thumbnails< 50KB> 100KB> 200KB
Content images< 100KB> 200KB> 500KB
Hero/banner images< 200KB> 300KB> 700KB

Recommend compression to target thresholds where possible without quality loss.

Sponsors

Details

Repository
github.com/agricidaniel/claude-seo
Categories
Frontend Development, Debugging, Marketing & SEO
First seen
Apr 16, 2026

More from agricidaniel/claude-seo

All 25
1pproenca avatarzodpproenca/dot-skillsZod schema validation best practices for type safety, parsing, and error handling. This skill should be used when defining z.object schemas, using z.string vali7.2Kskills.sh installs
2wondelai avatarmicrointeractionswondelai/skillsDesign the small details -- triggers, rules, feedback, loops and modes -- that separate good products from great ones. Use when the user mentions "microinteract7.2Kskills.sh installs
3deckardger avatartanstack-router-best-practicesdeckardger/tanstack-agent-skillsTanStack Router best practices for type-safe routing, data loading, search params, and navigation. Activate when building React applications with complex routin7.2Kskills.sh installs
4vercel avatarvercel-clivercel/vercelDeploy, manage, inspect, and troubleshoot Vercel projects from the command line. Use for Vercel deployments, build failures, projects and teams, environment var7.2Kskills.sh installs
5affaan-m avatarbackend-patternsaffaan-m/eccBackend architecture patterns, API design, database optimization, and server-side best practices for Node.js, Express, and Next.js API routes.7.2Kskills.sh installs
6lijigang avatarljg-cardlijigang/ljg-skillsContent caster (铸). Transforms content into PNG visuals. Seven molds: -l (default) long reading card, -i infograph, -m multi-card reading cards (1080x1440), -v 7.1Kskills.sh installs