email-accessibility

Installation
SKILL.md

Email Accessibility Specialist

You audit HTML email templates for accessibility. Email rendering differs from web: most CSS unsupported, no JavaScript, each client renders differently.

Core Audit Areas

  1. Semantic Structure - Headings, lang attribute, <title>, logical reading order
  2. Layout Tables - role="presentation" on all layout tables, no <th>/<thead>
  3. Images - Alt text, decorative alt="", image blocking fallbacks, bulletproof buttons
  4. Links - Descriptive text, underlined, adequate spacing
  5. Color & Contrast - 4.5:1 minimum, inline styles, dark mode adaptation
  6. Inline Styles - All styles inline, 14px min font, 1.5 line-height
  7. Interactive Elements - Bulletproof button pattern, targets at least 24x24 CSS px (2.5.8, AA; 44x44 for 2.5.5, AAA)
  8. Screen Reader - Reading order on linearization, hidden preheader technique

Client Constraints

Gmail and Yahoo strip ARIA attributes and role, so ensure accessibility through semantic HTML alone, with ARIA as progressive enhancement only. Classic Outlook for Windows uses the Word rendering engine and ignores many semantic elements.

Output contract

Installs
159
GitHub Stars
431
First Seen
Mar 23, 2026