Audits HTML email templates for the specific accessibility challenges of email clients, where you can't rely on modern CSS or ARIA attributes. Covers the fundamentals: semantic heading structure, proper table roles for layout, alt text and image blocking fallbacks, color contrast with inline styles, and bulletproof button patterns. The constraint here is real: Gmail and Yahoo strip ARIA, so everything has to work through semantic HTML and inline styles alone. Useful when you're building transactional emails or newsletters and need to catch issues before they hit inboxes, especially around screen reader compatibility and dark mode handling.

skills.sh installs
162
GitHub stars
442
last updated
Aug 21, 2026

Install

$ npx -y skills add community-access/accessibility-agents --skill email-accessibility --agent claude-code

Installs into .claude/skills of the current project.

Files

Email Accessibility Specialist

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

Skills: kb-email-accessibility

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.

Sponsors

Details

Repository
github.com/community-access/accessibility-agents
Categories
Frontend Development, Design & UI/UX, CLI & Terminal
First seen
Jun 3, 2026

More from community-access/accessibility-agents

All 25
1jerrar670 avatarimplement_lenis_scrolljerrar670/surf-websiteInstructions for implementing Lenis smooth scrolling in a Next.js or React application.162skills.sh installs
2solar-luna avatarwechat-article-formattersolar-luna/fully-automatic-article-generation-skill将Markdown文章转换为美化的HTML格式,适配微信公众号发布。应用专业CSS样式、代码高亮、优化排版。当用户说"美化这篇文章"、"转换为HTML"、"优化公众号格式"、"生成公众号HTML"时使用。157skills.sh installs
3oimiragieo avatardiagram-generatoroimiragieo/agent-studioGenerates architecture, database, and system diagrams using Mermaid syntax. Creates visual representations of system architecture, database schemas, component r146skills.sh installs
4webmaxru avatarenonic-webhook-integratorwebmaxru/enonic-agent-skillsSets up Enonic XP event listeners, webhook configurations, and external system integrations triggered by content lifecycle events. Covers lib-event listener reg144skills.sh installs
5postplusai avatarxiaohongshu-article-packagerpostplusai/postplus-skillsLay out an existing draft or script into a Xiaohongshu image-post or long-image package without rewriting the source. Use this when the user wants pagination, h138skills.sh installs
6yonatangross avatardashboard-patternsyonatangross/orchestkitDashboard UI patterns with widget composition, real-time data updates, responsive grid layouts, and data tables for React applications. Use when building dashbo124skills.sh installs