Check Images

check-images

Analyze and validate images on web pages. Use when users ask to check image alt tags, verify image accessibility, find missing alt attributes, audit image SEO, or check image optimization. Detects missing alt, empty alt, decorative images without proper markup, oversized images, and missing dimen...

majiayu000/claude-skill-registry·0installs663starsMarketing

SKILL.md

Full skill instructions

Check Images

Analyze and validate images on web pages for accessibility and SEO compliance.

Quick Start

cd /path/to/html-checker/scripts
bun src/check-images.ts <URL>

CLI Options

Option	Short	Default	Description
`--verbose`	`-v`	false	Show all images including valid ones
`--json`	`-j`	false	Output results as JSON

Checks Performed

Check	Severity	Description
Missing alt	Error	Image has no alt attribute
Empty alt	Warning	Image has alt="" (verify if decorative)
Generic alt	Warning	Alt text like "image", "photo", "picture"
Long alt	Info	Alt text exceeds 125 characters
Missing dimensions	Warning	No width/height attributes (CLS risk)
No lazy loading	Info	Large images without loading="lazy"

Usage Examples

# Basic check
bun src/check-images.ts https://example.com

# Verbose output
bun src/check-images.ts https://example.com --verbose

# JSON output
bun src/check-images.ts https://example.com --json

Output Example

Image Analysis for https://example.com

Summary:
  Total Images: 25
  With alt: 20
  Missing alt: 3
  Empty alt: 2

Issues Found: 5
  [ERROR  ] Missing alt at position 5
    <img src="/hero.jpg">
  [WARNING] Empty alt at position 12
    <img src="/divider.png" alt="">
  [WARNING] Generic alt at position 18
    <img src="/team.jpg" alt="image">

Recommendations:
  - Add descriptive alt text to all informative images
  - Use alt="" only for decorative images
  - Add width/height to prevent layout shifts

Accessibility Guidelines

Informative images: Describe the content/function
Decorative images: Use empty alt (alt="")
Functional images: Describe the action (e.g., "Search", "Submit")
Complex images: Use longdesc or aria-describedby

SEO Impact

Alt text helps search engines understand images
Improves image search rankings
Required for Google Images indexing

Related Files

Command: plugins/html-checker/commands/check-images.md
Scripts: plugins/html-checker/scripts/src/check-images.ts
Check Links: plugins/html-checker/skills/check-links/
Check A11y: plugins/html-checker/skills/check-a11y/

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/majiayu000/claude-skill-registry --skill check-images

View on GitHub

skills/data/check-images/SKILL.md

More Marketing skills

View all

Marketing

copywriting

Marketing copy for homepages, landing pages, pricing pages, and other conversion-focused web pages.

53.3K 216.1K

View

Marketing

flux-2-klein

Fast image generation with Flux 2 Klein, optimized for sub-second iteration and multi-reference brand styling.

52 176.2K

View

Marketing

marketing-psychology

Psychological principles and mental models for understanding customer behavior and influencing marketing decisions.

53.3K 153K

View

Marketing

content-strategy

Plan searchable and shareable content that drives traffic, builds authority, and generates leads.

53.3K 150.9K

View

Marketing

programmatic-seo

Build SEO-optimized pages at scale using templates, data, and proven playbook patterns.

53.3K 140.1K

View

Marketing

marketing-ideas

Brainstorm and prioritize marketing strategies tailored to your SaaS stage, budget, and goals.

53.3K 137.2K

View

Marketing

ai-seo

Optimize content for discovery, citation, and visibility across AI search platforms and LLM assistants.

53.3K 136.7K

View

Marketing

copy-editing

Systematic improvement of existing marketing copy through seven focused editing passes.

53.3K 136.4K

View

Marketing

site-architecture

Plan and optimize your website's page hierarchy, navigation, URL structure, and internal linking.

53.3K 112.8K

View

Marketing

revops

Design and optimize systems connecting marketing, sales, and customer success into a unified revenue engine.

53.3K 104.9K

View

Marketing

brand-guidelines

Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.

179.7K 100.1K

View