Rich Email
Create a reviewable, email-safe HTML message and open it as an unsent New Outlook draft. This skill composes with the existing md-to-eml converter and adds only draft composition, validation, and Outlook opening.
When to Use
Use for:
- Rich stakeholder or executive updates
- Research or release summary emails
- Emails with headings, callouts, tables, or evidence links
- Reformatting a plain-text message into a professional draft
Do not use for automated newsletters, transactional mail, SMTP, Graph, SendGrid, or bulk delivery. Those require a separately governed delivery system and compliance flow.
Draft Boundary
The workflow creates and opens an unsent draft only. Never send automatically. Before opening the draft, show or summarize the exact recipients, subject, requested action, and body. A later send requires explicit approval of that exact message.
Outlook supplies the default signature. Do not add a generated signoff or sender name. The helper inserts two blank lines before the rich content so the user can remove or reposition the signature.
Procedure
- Confirm the audience, recipients, purpose, requested action, tone, and whether the user wants a draft or a send.
- Copy the email template to a temporary file outside the repository and adapt it using the style guide.
- Keep
to, from, and subject frontmatter values unquoted. The converter copies those values into EML headers verbatim.
- Use the existing
md-to-eml converter without --inline-images. This first Outlook helper accepts single-part text/html EML and rejects multipart output rather than risking attachment corruption.
- Validate the EML:
node skills/rich-email/scripts/open-rich-outlook-draft.cjs `
"$env:TEMP\message.eml" --validate-only
- Inspect the validation output and decoded HTML. Confirm recipients, subject, readable headings, compact tables, correct links, no raw Markdown, no signoff, and no secrets.
- On Windows with New Outlook installed, open the unsent draft:
node skills/rich-email/scripts/open-rich-outlook-draft.cjs `
"$env:TEMP\message.eml"
The helper requires olk.exe or outlook.exe. Validation-only mode remains available on other hosts; it does not claim that a generic file opener proves New Outlook opened.
- In New Outlook, verify the signature order, two blank lines, recipients, subject, links, tables, and absence of unexpected attachments. Ask the user to confirm the draft before any separate send action.
- Delete temporary Markdown, EML, decoded HTML, and screenshots after the draft is saved or discarded. Confirm no email artifacts remain in the repository and preserve no recipients or body text in persistent memory.
Content Rules
- Use one literal subject, ideally under 60 characters.
- Lead with the outcome, decision, or request.
- Use one executive-summary callout for messages over 250 words.
- Use at most two compact tables.
- Use descriptive links instead of raw URLs.
- Separate evidence from recommendation.
- Do not include secrets, credentials, unnecessary personal data, or clinical intake content.
Failure Handling
| Signal |
Action |
Pandoc or md-to-eml unavailable |
Stop and report the prerequisite; do not install it without approval. |
| Multipart EML or inline-image output |
Stop with the helper's clear unsupported-format message; do not open a partial draft. |
| Missing or malformed headers |
Fix Markdown frontmatter and reconvert. |
| New Outlook launcher unavailable |
Use --validate-only and report that opening the draft requires Windows New Outlook. |
| Draft does not open |
Keep the EML for diagnosis and do not claim that a draft opened. |
| User requests sending |
Reconfirm the exact message and obtain explicit send authorization. |
Validation Commands
node --test scripts/test-rich-email.cjs
node skills/rich-email/scripts/open-rich-outlook-draft.cjs message.eml --validate-only
git status --short
Would Revise If
Revisit by 2026-11-11 if multipart email is required by two real workflows, New Outlook cannot be opened reliably on supported Windows hosts, any draft is sent without explicit authorization, or the capability proves unrelated to Document Tools ownership.
1---2name: rich-email3description: Create and validate polished HTML email drafts from Markdown, then open an unsent New Outlook draft on Windows. Use for rich stakeholder updates, executive summaries, or formatted email requests; do not use for automated, transactional, or bulk delivery.4---56# Rich Email78Create a reviewable, email-safe HTML message and open it as an unsent New Outlook draft. This skill composes with the existing [md-to-eml](../md-to-eml/SKILL.md) converter and adds only draft composition, validation, and Outlook opening.910## When to Use1112Use for:1314- Rich stakeholder or executive updates15- Research or release summary emails16- Emails with headings, callouts, tables, or evidence links17- Reformatting a plain-text message into a professional draft1819Do not use for automated newsletters, transactional mail, SMTP, Graph, SendGrid, or bulk delivery. Those require a separately governed delivery system and compliance flow.2021## Draft Boundary2223The workflow creates and opens an unsent draft only. Never send automatically. Before opening the draft, show or summarize the exact recipients, subject, requested action, and body. A later send requires explicit approval of that exact message.2425Outlook supplies the default signature. Do not add a generated signoff or sender name. The helper inserts two blank lines before the rich content so the user can remove or reposition the signature.2627## Procedure28291. Confirm the audience, recipients, purpose, requested action, tone, and whether the user wants a draft or a send.302. Copy [the email template](./assets/rich-email-template.md) to a temporary file outside the repository and adapt it using [the style guide](./references/style-guide.md).313. Keep `to`, `from`, and `subject` frontmatter values unquoted. The converter copies those values into EML headers verbatim.324. Use the existing `md-to-eml` converter without `--inline-images`. This first Outlook helper accepts single-part `text/html` EML and rejects multipart output rather than risking attachment corruption.335. Validate the EML:3435```powershell36node skills/rich-email/scripts/open-rich-outlook-draft.cjs `37 "$env:TEMP\message.eml" --validate-only38```39406. Inspect the validation output and decoded HTML. Confirm recipients, subject, readable headings, compact tables, correct links, no raw Markdown, no signoff, and no secrets.417. On Windows with New Outlook installed, open the unsent draft:4243```powershell44node skills/rich-email/scripts/open-rich-outlook-draft.cjs `45 "$env:TEMP\message.eml"46```4748The helper requires `olk.exe` or `outlook.exe`. Validation-only mode remains available on other hosts; it does not claim that a generic file opener proves New Outlook opened.49508. In New Outlook, verify the signature order, two blank lines, recipients, subject, links, tables, and absence of unexpected attachments. Ask the user to confirm the draft before any separate send action.519. Delete temporary Markdown, EML, decoded HTML, and screenshots after the draft is saved or discarded. Confirm no email artifacts remain in the repository and preserve no recipients or body text in persistent memory.5253## Content Rules5455- Use one literal subject, ideally under 60 characters.56- Lead with the outcome, decision, or request.57- Use one executive-summary callout for messages over 250 words.58- Use at most two compact tables.59- Use descriptive links instead of raw URLs.60- Separate evidence from recommendation.61- Do not include secrets, credentials, unnecessary personal data, or clinical intake content.6263## Failure Handling6465| Signal | Action |66| --- | --- |67| Pandoc or `md-to-eml` unavailable | Stop and report the prerequisite; do not install it without approval. |68| Multipart EML or inline-image output | Stop with the helper's clear unsupported-format message; do not open a partial draft. |69| Missing or malformed headers | Fix Markdown frontmatter and reconvert. |70| New Outlook launcher unavailable | Use `--validate-only` and report that opening the draft requires Windows New Outlook. |71| Draft does not open | Keep the EML for diagnosis and do not claim that a draft opened. |72| User requests sending | Reconfirm the exact message and obtain explicit send authorization. |7374## Validation Commands7576```powershell77node --test scripts/test-rich-email.cjs78node skills/rich-email/scripts/open-rich-outlook-draft.cjs message.eml --validate-only79git status --short80```8182## Would Revise If8384Revisit by **2026-11-11** if multipart email is required by two real workflows, New Outlook cannot be opened reliably on supported Windows hosts, any draft is sent without explicit authorization, or the capability proves unrelated to Document Tools ownership.
fabioc-aloha