send_gmail git:20261101.a39418bA

Immutable. This exact content never changes and is served at /api/v1/blob/b9f16f352ce14b85.

---
name: send_gmail
description: Render a complete Markdown insight as readable HTML with inline styling and send it through gws. Use through distribution_policy, which decides who receives which insight; the CLI only converts for previews.
---

# Send Gmail

Render and send insight emails. Who receives which insight is decided by
[distribution_policy](../distribution_policy/SKILL.md); agents email requested
insights through its `requested` command, not through `gws` directly. If `gws`
is unavailable, provide the insight in chat without offering email.

## Operations and effects

`send_gmail(markdown, recipients, subject)` sends the complete Markdown content
in the body of one HTML email, without attachment, through the shared
`send_html_email` from `lib.infrastructure.gmail`. It raises when `gws` fails.
A failed send may still have been delivered, so callers do not retry it
automatically.

`markdown_to_email(markdown)` renders the HTML. It uses `markdown-it-py` and
Beautiful Soup from `sictic-env`, applies inline styling for typography, lists,
code and tables, preserves Markdown links and escapes raw HTML.

## Usage

Convert a Markdown file to styled HTML to preview an email; the helper prints
the path to a unique temporary file:

```bash
conda run -n sictic-env python -m skills.send_gmail /path/to/insight.md
```

`--output /path/to/email.html` selects an output path. The CLI only converts
files; `gws` owns authentication and sending. There is no bulk refresh or
harness registration.

## References

- [Rendering](render_email.py), [sending](send_gmail.py), [CLI](__main__.py)
- [Distribution rules](../distribution_policy/SKILL.md)