accessibility-alt-text-auditor

When to invoke

• You maintain a website/app content library and want to improve accessibility.
• You need an audit of missing or low-quality alt text for images.

Inputs needed

• A JSON export of images with fields: page, src, alt.
• Optional policy: minimum alt length, banned phrases, whether decorative images may be empty.

Workflow

1. Validate input records and normalize text.
2. Score each image:
   • Missing alt
   • Empty alt (allowed only if decorative)
   • Too short / too long
   • Generic alt (e.g., “image”, “photo”, file names)
3. Produce a remediation list sorted by severity.
4. Summarize coverage and common issues.