email-sender_skill

Overview

This skill sends emails over SMTP using nodemailer, supporting HTML templates, multiple recipients, and file attachments. It is implemented in TypeScript and configured via environment variables for SMTP host, port, user, and password. The tool is designed for reliable programmatic email delivery from servers or automation scripts.

How this skill works

The skill constructs MIME-compliant messages with optional HTML body, plain-text fallback, and attached files, then hands them to nodemailer which speaks SMTP to the configured mail server. Recipients can be a single address, comma-separated list, or arrays for To/Cc/Bcc. Credentials and sender identity are provided via environment variables to keep secrets out of code.

When to use it

• Send automated notifications from a backend service or cron job
• Deliver reports or logs as file attachments to multiple stakeholders
• Distribute HTML newsletters or templated messages programmatically
• Trigger transactional emails from webhooks, forms, or CI pipelines
• Replace manual email sending in batch workflows or scripts

Best practices

• Use environment variables for SMTP credentials and sender address to avoid hardcoding secrets
• Provide both HTML and plain-text bodies to maximize deliverability and accessibility
• Limit attachment sizes and validate file types before sending
• Use To/Cc/Bcc appropriately and respect recipient privacy with Bcc for large lists
• Monitor SMTP response and implement retry logic for transient errors

Example use cases

• Send a daily PDF report to a team distribution list with the report attached
• Deliver password reset or account verification emails from a web app
• Distribute build artifacts or logs after CI completion to developers
• Send a templated newsletter with inline images and a plain-text fallback
• Notify on-call engineers via email when monitoring alerts trigger