docs(skill): add email accessibility guidance to skill#3550
docs(skill): add email accessibility guidance to skill#3550hermesresend wants to merge 2 commits into
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.
|
|
@hermesresend is attempting to deploy a commit to the resend Team on Vercel. A member of the Team first needs to authorize it. |
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
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: These changes only update documentation in markdown files to improve accessibility guidance for the react-email skill, with no code or logic changes, making them safe to auto-approve.
Re-trigger cubic
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.
christina-de-martinez
changed the title
There was a problem hiding this comment.
0 issues found across 3 files (changes from recent commits).
Auto-approved: These documentation updates improve accessibility guidance for the react-email skill by correcting alt-text rules and adding structured recommendations, with no changes to code, configuration, or business logic.
Re-trigger cubic
|
Closed in favor of #3551 |
|
Superseded by #3551 (same commits rebased onto an upstream branch by @christina-de-martinez). Closing this one to keep review in one place. |
2 participants
Updates the
react-emailagent skill so agents using it produce accessible emails by default, matching the new accessibility defaults shipped in the latest release and the findings of the Email Markup Consortium's 2026 accessibility report (0.002% pass rate across 376,348 emails).What changes
skills/react-email/SKILL.mdalttext," which is wrong for decorative images and conflicts with the new<Img alt="">default.skills/react-email/references/COMPONENTS.md<Img>props: notes thataltdefaults to""instead of marking it as required (it isn't anymore), and rewrites the best practices to distinguish meaningful vs. decorative images.<Section>docs: notes that layout components (<Section>,<Row>,<Container>,<Markdown>tables) renderrole="presentation"by default so screen readers don't announce them as data tables, and reminds authors to add it themselves on any raw<table>they drop in.skills/react-email/references/STYLING.mdWhy
Agents using this skill generate the templates. If the skill still says "always include alt text," they'll plaster
alt="image"on decorative spacers and clutter every screen reader. Better to teach the right rule once.A companion PR adds a full accessibility reference to the
email-best-practicesskill: resend/email-best-practices#16