Alt Text & Headings

Audit image alt text and validate heading structures against WCAG AA standards.

387|42|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/Community-Access/accessibility-agents --skill alt-text-headings
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Alt Text & Headings
Source: https://github.com/Community-Access/accessibility-agents/tree/main/.gemini/extensions/a11y-agents/skills/alt-text-headings
Command: npx skills add https://github.com/Community-Access/accessibility-agents --skill alt-text-headings

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the critical accessibility issues of missing or inaccurate alternative text for images and improper heading structures, ensuring that web content is perceivable and navigable for all users, including those using screen readers.

Core Features & Use Cases

  • Image Alt Text Analysis: Visually analyzes images and evaluates existing alt text for accuracy, completeness, and appropriateness, suggesting improvements or generating new alt text.
  • Heading Structure Validation: Audits heading hierarchies (H1-H6) to ensure logical document structure and proper semantic outlining.
  • Use Case: When developing a new marketing webpage with product images and detailed feature descriptions, this Skill can automatically check that all product images have descriptive alt text and that the page's headings (e.g., "Features", "Specifications", "Pricing") are correctly ordered and structured for screen reader navigation.

Quick Start

Analyze the provided webpage for any missing or inaccurate image alt text and verify the heading structure is semantically correct.

Frequently Asked Questions about Alt Text & Headings

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

FAQPage Schema
How do I check if my web content meets WCAG AA accessibility standards?

To check if your web content meets WCAG AA accessibility standards, audit alternative text for images and validate heading structures to ensure logical document outlines for screen reader navigation.

How do I generate accurate alt text for website images and SVGs?

Generate accurate alt text for website images and SVGs by visually analyzing the content against provided descriptions, identifying inaccuracies, and suggesting appropriate alternatives based on W3C image categories.

What is the correct way to validate heading levels for screen reader navigation?

Validate heading levels for screen reader navigation by auditing heading hierarchies from H1 through H6, verifying proper semantic outlining, and checking landmark structures and page titles according to WCAG standards.

Does this accessibility audit evaluate decorative icons and videos or just standard images?

This accessibility audit evaluates decorative icons and videos along with standard images, specializing in auditing alternative text for images, SVGs, icons, videos, and figures to ensure all web content is perceivable.

Why does my webpage heading structure fail semantic outlining?

Your webpage heading structure fails semantic outlining when heading levels are skipped or improperly ordered, which this analysis detects by validating H1 through H6 hierarchies against logical document outline requirements.