seo-images

Analyze HTML image markup and report SEO and performance issues.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/puertasbogota/seo-prueba1 --skill seo-images-puertasbogota
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-images
Source: https://github.com/puertasbogota/seo-prueba1/tree/main/skills/seo-images
Command: npx skills add https://github.com/puertasbogota/seo-prueba1 --skill seo-images-puertasbogota

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a systematic analysis of image-related SEO and performance issues so teams can reduce page weight, fix accessibility problems, and improve Core Web Vitals tied to images.

Core Features & Use Cases

  • Alt text auditing: detect missing or non-descriptive alt attributes and suggest improvements for accessibility and relevance.
  • Performance checks: identify oversized images, inefficient formats, and opportunities for WebP/AVIF conversion with estimated savings.
  • Responsive & lazy-loading validation: verify srcset/sizes, picture element usage, loading and decoding attributes, and fetchpriority for LCP images.
  • CLS and dimensions: flag images missing width/height or aspect-ratio rules that create layout shifts.
  • Use Case: Run a site or page audit to produce a prioritized optimization list for developers and content editors.

Quick Start

Run an image optimization audit for the page URL and return a prioritized list of fixes and estimated savings.

Frequently Asked Questions about seo-images

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

FAQPage Schema
How do I audit images for SEO and performance issues on a web page?

To audit images for SEO, analyze the HTML markup to detect missing alt text, oversized files, and inefficient formats. An image optimization audit extracts page metadata to evaluate lazy-loading behavior and CLS dimensions, generating a prioritized list of fixes.

What is causing layout shift (CLS) from images and how do I fix it?

Layout shift (CLS) from images is caused by missing width, height, or aspect-ratio rules in the markup. Fixing CLS involves flagging images lacking these dimensions and adding explicit attributes to prevent layout shifts as images load.

How do I check if images are using responsive srcset and proper lazy-loading?

Checking responsive srcset and lazy-loading involves verifying the HTML for srcset, sizes, picture elements, and loading attributes. The audit extracts markup to validate these properties and surfaces recommendations for correct responsive behavior.

Can I estimate file size savings from converting images to WebP or AVIF?

Yes, you can estimate compression savings for WebP or AVIF conversion. The audit evaluates current file formats and dimensions to calculate potential byte reductions, identifying oversized images and opportunities for modern format optimization.

Does the image audit work with CDN-hosted assets and inaccessible images?

Yes, the image audit handles inaccessible or CDN-hosted assets gracefully. It extracts available metadata from the HTML markup to evaluate formats and dimensions without failing when direct asset access is restricted.

When do I need to optimize alt text for accessibility and SEO relevance?

You need to optimize alt text when attributes are missing or non-descriptive to ensure accessibility and SEO relevance. The audit detects these issues and suggests improvements to make images understandable for screen readers and search engines.