OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add wangyendt/wayne-skills --skill send-email
Send emails via SMTP with support for HTML formatting, file attachments, and email templates. Use when users ask to: (1) Send an email, (2) Email someone, (3) Send a notification, (4) Use email templates, or (5) Send files via email.
npx skills add wangyendt/wayne-skills --skill send-email
Send emails via SMTP using Python with support for plain text, HTML formatting, file attachments, and template-based emails.
agent_skill_test@126.com when no sender is specifiedThis skill guides you through the email sending process step by step.
Ask the user for the following required information. If any is missing, prompt the user to provide it:
| Information | Description | Example |
|---|---|---|
Recipient (--to) | Email address to send to | user@example.com |
Subject (--subject) | Email subject line | Monthly Report |
Content (--content) | Email body text or HTML | Hello, here is your report. |
IMPORTANT - Default Sender Email Behavior:
If the user does NOT specify a sender email in their initial request, AUTOMATICALLY use agent_skill_test@126.com as the default sender. DO NOT ask the user which email to send from.
Only ask the user for a different sender email if they explicitly mention wanting to use their own email address.
When using the default agent_skill_test@126.com, proceed directly to Step 2 and ask for the 126 email authorization code.
Based on the sender's email address domain, identify the email provider and request the appropriate credentials.
Gmail (@gmail.com, @googlemail.com)
smtp.gmail.com587 (TLS) or 465 (SSL)Outlook / Office 365 (@outlook.com, @hotmail.com, @live.com, @office365.com)
smtp.office365.com587 (TLS)QQ Mail (@qq.com, @vip.qq.com)
smtp.qq.com587 (TLS) or 465 (SSL)NetEase 163 Mail (@163.com)
smtp.163.com465 (SSL) or 994 (IMAP)NetEase 126 Mail (@126.com)
smtp.126.com465 (SSL) or 25 (SSL)SendGrid
smtp.sendgrid.net587 (TLS) or 465 (SSL)apikey (literally this string)Mailgun
smtp.mailgun.org587 (TLS)Custom SMTP (Other domains) Ask the user to provide:
The script automatically detects if the email content is in Markdown format by looking for common patterns:
#, ##, ###)**bold**, *italic*)- item or 1. item)[text](url))If Markdown is detected, the content is automatically converted to beautifully styled HTML with:
You don't need to manually specify --content-type html for Markdown content - it's handled automatically!
--from-name: Display name for sender (e.g., "John Doe")--content-type html: For HTML formatted emails (defaults to plain text, but auto-converts Markdown)--attach: File path(s) to attach (can specify multiple)--template: Use template file instead of content--template-vars: JSON string of template variablesBefore sending, confirm with the user:
If confirmed, execute the send_email.py script with all collected parameters.
User: Send an email to john@example.com with subject "Hello"
Skill: I can help you send that email. I need a few more details:
User: The content is "Hi John, just saying hello!" and send from myemail@gmail.com
Skill: I detected you're using Gmail. For Gmail, you need an App Password (not your regular password).
To get your App Password:
Please provide your Gmail App Password:
User: abcd efgh ijkl mnop
Skill: Ready to send:
Proceed to send? (y/n)
User: 发一封邮件给 manager@company.com,主题是"AR眼镜行业分析",内容是 [用户提供的 Markdown 报告]
Skill: 我来帮您发送这封邮件。检测到您没有指定发件人邮箱,我将使用默认邮箱 agent_skill_test@126.com 发送。
同时,我发现您的内容是 Markdown 格式,将自动转换为美观的 HTML 格式,让报告更易读。
为了使用 126 邮箱发送,我需要您提供 SMTP 授权码。
获取授权码步骤:
请提供 agent_skill_test@126.com 的授权码:
User: [提供授权码]
Skill: 准备发送邮件:
确认发送? (y/n)
User: 发邮件给 user@company.com，主题是项目报告
Skill: 我需要收集邮件内容：
邮件正文是什么？
User: 项目已完成，所有里程碑都已达成。
Skill: 我将使用默认邮箱 agent_skill_test@126.com 发送。
为了使用 126 邮箱发送，我需要您提供 SMTP 授权码。
获取授权码步骤：
请提供 agent_skill_test@126.com 的授权码：
User: [提供授权码]
Skill: 准备发送邮件：
确认发送？(y/n)
User: Send a report to boss@company.com from myname@outlook.com about Q4 results, with attachment /home/user/q4_report.pdf
Skill: I'll help you send that email. Please provide the email content:
What should the email say about the Q4 results?
User: Please find attached the Q4 financial report. Let me know if you have any questions.
Skill: I see you're using Outlook. You'll need your Outlook account password (same as web login).
Please provide your Outlook password:
User: mypassword123
Skill: Ready to send:
Proceed to send? (y/n)
User: Send email to test@domain.com from my@domain.com
Skill: I need to gather some information:
User: Subject is Test Email, content is Hello World
Skill: Since you're using a custom domain (my@domain.com), I'll need your SMTP configuration:
User: Server is smtp.mydomain.com, port 587, username is my@domain.com, password is secret
Skill: Ready to send:
Proceed to send? (y/n)
Once all information is collected, execute the script with appropriate parameters:
| Provider | SMTP Server | Port | Encryption | Password Type | Username |
|---|---|---|---|---|---|
| Gmail | smtp.gmail.com | 587 | TLS | App Password | Full email |
| Gmail | smtp.gmail.com | 465 | SSL | App Password | Full email |
| Outlook | smtp.office365.com | 587 | TLS | Account Password | Full email |
| QQ Mail | smtp.qq.com | 587 | TLS | Authorization Code | Full email |
| QQ Mail | smtp.qq.com | 465 | SSL | Authorization Code | Full email |
| 163 Mail | smtp.163.com | 465 | SSL | Authorization Code | Full email |
| 163 Mail | smtp.163.com | 994 | SSL | Authorization Code | Full email |
| 126 Mail | smtp.126.com | 465 | SSL | Authorization Code | Full email |
| 126 Mail | smtp.126.com | 25 | SSL | Authorization Code | Full email |
| SendGrid | smtp.sendgrid.net | 587 | TLS | API Key | apikey |
| SendGrid | smtp.sendgrid.net | 465 | SSL | API Key | apikey |
| Mailgun | smtp.mailgun.org | 587 | TLS | SMTP Password | From dashboard |
Before using this skill, install the required Python dependencies:
This installs the markdown library (version ≥3.4.0) which is required for automatic Markdown to HTML conversion.
Main Python script for sending emails. Supports:
Common SMTP server configurations including Gmail, Outlook, 126, QQ, 163, SendGrid, Mailgun, and Aliyun.
Email templates:
simple-notification.html - Basic notification templatereport-summary.html - Professional report template with metrics gridpython3 scripts/send_email.py \
--to recipient@example.com \
--subject "Email Subject" \
--content "Email body content" \
--smtp-server smtp.gmail.com \
--smtp-port 587 \
--username your@email.com \
--password your-password-or-app-passwordpython3 scripts/send_email.py \
--to recipient@example.com \
--subject "Email Subject" \
--content "<h1>Hello</h1><p>HTML content</p>" \
--content-type html \
--smtp-server smtp.gmail.com \
--smtp-port 587 \
--username your@email.com \
--password your-passwordpython3 scripts/send_email.py \
--to recipient@example.com \
--subject "Email Subject" \
--content "Email body" \
--attach /path/to/file1.pdf \
--attach /path/to/file2.csv \
--smtp-server smtp.gmail.com \
--smtp-port 587 \
--username your@email.com \
--password your-passwordpython3 scripts/send_email.py \
--to recipient@example.com \
--subject "Email Subject" \
--template assets/simple-notification.html \
--template-vars '{"title":"Notification","message":"Your report is ready!"}' \
--content-type html \
--smtp-server smtp.gmail.com \
--smtp-port 587 \
--username your@email.com \
--password your-passwordpython3 scripts/send_email.py \
--to recipient@example.com \
--subject "Email Subject" \
--content "Email body" \
--smtp-server smtp.gmail.com \
--smtp-port 465 \
--use-ssl \
--username your@email.com \
--password your-passwordpip install -r requirements.txt