Text Quality Reviewer

text-quality-reviewer - Non-Visual Text Quality Review

Scans your code for low-quality non-visual text that would confuse or mislead screen reader users. Catches template variables in alt text ({0}, {{var}}), code syntax used as accessible names (property.alttext), placeholder text as labels ("TODO", "FIXME"), attribute names used as their own values (aria-label="ARIA Label"), filename alt text (DSC_0492.jpg), whitespace-only names, duplicate control labels, and visible text that contradicts the programmatic label.

When to Use It

• After a CMS migration or template engine change -- template bindings are the #1 source of broken alt text
• When auditing a React, Vue, or Angular app for framework binding mistakes
• When QA or a screen reader user reports "the button just says 'button'"
• When reviewing alt text across a site for quality, not just presence
• When checking aria-labels for placeholder or development leftover text
• When verifying that visible button names match their programmatic labels (WCAG 2.5.3)

What It Catches

Expand - 10 text quality issues detected

Rule	Severity	What It Catches
TQR-001	Critical	Unresolved template variables: {0}, {{var}}, ${expr}, %s
TQR-002	Critical	Code syntax as names: property.alttext, heroImageAlt, btn_label
TQR-003	Serious	Placeholder text: TODO, FIXME, lorem ipsum, "image", "photo"
TQR-004	Critical	Attribute name as its own value: alt="alt text", aria-label="ARIA Label"
TQR-005	Critical	Whitespace-only or zero-width accessible names
TQR-006	Serious	Duplicate accessible names on different controls
TQR-007	Serious	Filename or file path as alt text: DSC_0492.jpg
TQR-008	Moderate	Single-character or extremely short labels on non-icon elements
TQR-009	Serious	Visible text contradicts aria-label (WCAG 2.5.3 Label in Name)
TQR-010	Moderate	Raw/zero-state dynamic content: [object Object], unfilled data

What It Will Not Catch

Missing alt attributes (that is alt-text-headings), invalid ARIA syntax (that is aria-specialist), ambiguous link text like "click here" (that is link-checker), or missing form label associations (that is forms-specialist). It focuses purely on whether the text content is meaningful and human-readable.

Example Prompts

Show example prompts

Claude Code

/text-quality-reviewer check all alt text and aria-labels for template variables
/text-quality-reviewer audit non-visual text quality across the marketing pages
/text-quality-reviewer find placeholder or TODO text in accessible names
/text-quality-reviewer review button labels in the component library

GitHub Copilot

@text-quality-reviewer scan alt text for code syntax or template variables
@text-quality-reviewer check aria-labels in this component
@text-quality-reviewer find duplicate button labels on this page
@text-quality-reviewer audit non-visual text quality in src/components/

Behavioral Constraints

Expand constraints

• Does not flag content inside code editor components, code blocks, or developer tools pages -- code syntax is expected in those contexts
• Evaluates alt text based on content quality, not contextual appropriateness (that is alt-text-headings)
• Requires 3+ descriptive words for meaningful image alt text -- single-word descriptions like "image" or "photo" are always flagged
• Checks that aria-label contains the visible text as a substring (WCAG 2.5.3 Label in Name)
• Treats whitespace-only accessible names as distinct from missing attributes -- both are failures, but for different reasons
• Catches framework-specific binding mistakes: alt="{alt}" in React (literal string instead of JSX expression), alt="item.alt" in Vue (missing v-bind)

Connections

Connect to	When
alt-text-headings	The alt attribute is missing entirely (structural issue, not a content quality issue)
aria-specialist	The ARIA attribute itself is invalid or structurally wrong
forms-specialist	The form label is not programmatically associated with the control
link-checker	The link text is vague ("click here") rather than defective (template variable)
accessibility-lead	For full-page audits that combine text quality with all other accessibility domains