Claude-skill-registry 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 dimensions.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/check-images" ~/.claude/skills/majiayu000-claude-skill-registry-check-images && rm -rf "$T"

manifest: skills/data/check-images/SKILL.md

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/
```