html-emaillisted
Install: claude install-skill ShlomiPorush/agent-skills
# HTML email
Rules for the HTML email an application sends, learned by measuring real clients. The evidence and its limits are in `references/outlook-dark-mode.md`. The test method is in `references/verification.md`. Read both before you change colours.
## First: find what exists
Before you change anything:
1. Find every place that builds email HTML: a shared layout, templates, inline builders. A fix must reach all of them.
2. Find what happens to the HTML after it is built. A CSS inliner or a template engine may drop `<style>` rules, attribute selectors or media queries. Check the final HTML that is sent, not the template.
3. Note the design: a light design with a dark-mode block, dark by default, or no `<style>` block at all. Keep the project's design. These rules fix how clients render it; they do not choose a new design.
4. Note which clients the users read mail in, when the owner knows. The colour and link facts below cover Outlook for Android and Outlook on the web only; the long-value facts cover classic Outlook for Windows and Outlook for Android.
## Outlook in dark mode
What was measured in October 2026 on Outlook for Android and on Outlook on the web (outlook.office.com), both in dark mode:
- Both recolour the email after its own `@media (prefers-color-scheme: dark)` block has applied. Outlook on the web applies that block when the computer or browser prefers dark, not because of Outlook's own theme.
- **Near-grey tints are flattened.** Surfaces that are almo