feat(skill): add email accessibility guidance to skill#3551
Conversation
Updates the react-email skill so agents using it produce accessible emails by default: - SKILL.md: rewrites the alt-text rule (no more 'always include alt text' which is wrong for decorative images) and adds an Accessibility section covering what React Email handles for free vs. what the author still has to do (headings, link copy, contrast, locale). - COMPONENTS.md: notes that <Img> defaults to alt="", clarifies meaningful vs. decorative image guidance, and documents that <Section>, <Row>, <Container>, and <Markdown> tables render role="presentation" by default. - STYLING.md: aligns alt-text guidance and adds a decorative-image example. Aligns with the new <https://emailmarkup.org/en/reports/accessibility/2026/|EMC 2026 accessibility report> findings and the react-email defaults shipped in the latest release.
Omitting the alt attribute is not equivalent to alt="". Some screen readers announce the filename when alt is missing, so decorative images must carry an explicit empty alt. Updates examples and wording to make this unambiguous.
|
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Per the EMC 2026 report, a linked image is functional, not decorative \u2014 its alt must describe where the link goes. Adds that rule to the Accessibility section and to the <Img> component reference. Also drops the 0.002% stat (the percentage is decoration for an agent skill; the actionable rules and link to the full reference in the email-best-practices skill are what matter) and notes the short-message exception for <h1>.
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
There was a problem hiding this comment.
0 issues found across 2 files (changes from recent commits).
Auto-approved: These changes are strictly documentation updates that add accessibility guidance to skill files, with no modifications to source code, configuration, or any deployable assets, so the risk of breaking anything is negligible.
Re-trigger cubic
There was a problem hiding this comment.
No issues found across 3 files
Confidence score: 5/5
- Automated review surfaced no issues in the provided summaries.
- No files require special attention.
Auto-approved: This is a documentation-only update that adds accessibility guidance to React Email skill docs, with no changes to source code, business logic, or infrastructure, and is thus low-risk and safe to auto-approve.
Re-trigger cubic
cpenned
changed the title
3 participants
Summary by cubic
Update
react-emailskill docs with practical accessibility guidance aligned to the latestreact-emaildefaults and EMC 2026. Clarifies alt-text (descriptive for meaningful images, explicitalt=""for decorative), documents defaults (<Html lang/dir>,<Img alt="">, layout tables withrole="presentation",<Preview>adds<title>), and tightens guidance on headings, link text, contrast, and locale.altmust describe the destination.<h1>.Written for commit 40505d6. Summary will update on new commits.
Review in cubic