Agent skill

Smtp Email Sender

by openakita in openakita/openakita

Send emails via SMTP (Gmail, Outlook, etc.). An agent skill from openakita/openakita.

AGPL-3.0Auto-check: notesBackend & APIs

Install Smtp Email Sender

skills CLI
$ npx skills add openakita/openakita --skill smtp-email-sender -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install openakita/openakita smtp-email-sender --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/openakita/openakita.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/smtp-email-sender .claude/skills/smtp-email-sender && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
smtp-email-sender
GitHub stars
2k
Token cost
~693 tokens
SKILL.md length
158 words
Files
5 (incl. scripts)
Skills in repo
29
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Send emails via SMTP (Gmail, Outlook, etc.). An agent skill from openakita/openakita.

  • Works in 6 steps: Gmail 用户 → Outlook/Hotmail 用户 → 企业邮箱用户 → …
  • User asks to send email
  • SKILL.md covers 前置要求, 配置, 使用方法 and 支持的 SMTP 配置, plus 3 more sections
  • Runs Python scripts from its folder; calls python; needs SMTP_PASSWORD

What it does

Smtp Email Sender is an agent skill from openakita/openakita. Send emails via SMTP (Gmail, Outlook, etc.). Supports attachments, HTML content, and multiple recipients. Use when user asks to send email, compose email, or email someone.

Its SKILL.md is about 690 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `.openakita-i18n.json`, `scripts/configure_smtp.py` and `scripts/send_email.py`).

It sits in Backend & APIs, covering Transactional email and Email management. It works with Gmail. The repository describes itself as: An open-source AI assistant framework with skills and agent architecture. The licence is AGPL-3.0.

When your agent uses it

  • User asks to send email
  • Tasks that involve Transactional email
  • Tasks that involve Email management

Example prompts

  • “/smtp-email-sender”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Gmail 用户
  2. Outlook/Hotmail 用户
  3. 企业邮箱用户
  4. 认证失败
  5. 连接超时
  6. 附件太大

What it can do on your machine

Read from SKILL.md and the folder at commit 5f5b38d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • account.microsoft.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SMTP_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Smtp Email Sender loads about 693 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 158 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~693

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:36
    在 `.env` 文件中添加以下环境变量:
  • NoteMentions a .env fileSKILL.md:183
    1. `.env` 文件配置是否正确

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from openakita/openakita at commit 5f5b38d, republished under its AGPL-3.0 licence (© openakita). 158 words, ~693 tokens.

Download SKILL.mdSave it as .claude/skills/smtp-email-sender/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
smtp-email-sender
description
Send emails via SMTP (Gmail, Outlook, etc.). Supports attachments, HTML content, and multiple recipients. Use when user asks to send email, compose email, or email someone.

SMTP Email Sender

通过 SMTP 协议发送邮件,支持 Gmail、Outlook、企业邮箱等。

前置要求

1. Gmail 用户

如果使用 Gmail,需要:

  1. 启用两步验证
  2. 创建应用专用密码(App Password)
2. Outlook/Hotmail 用户
  1. 启用两步验证
  2. 创建应用密码:https://account.microsoft.com/security
  3. 或使用普通密码(如果允许)
3. 企业邮箱用户

联系 IT 部门获取:

  • SMTP 服务器地址
  • SMTP 端口(通常 587 或 465)
  • 是否需要 SSL/TLS

配置

在 .env 文件中添加以下环境变量:

bash
# SMTP 配置
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=your_email@gmail.com
SMTP_PASSWORD=your_app_password  # Gmail 使用应用专用密码
SMTP_USE_TLS=true

或者首次使用时运行配置脚本。

使用方法

基本用法

调用 send_email.py 脚本:

bash
python scripts/send_email.py \
  --to recipient@example.com \
  --subject "邮件主题" \
  --body "邮件正文"
完整参数
参数必需说明
--to是收件人邮箱(多个用逗号分隔)
--subject是邮件主题
--body是邮件正文
--cc否抄送邮箱(多个用逗号分隔)
--bcc否密送邮箱(多个用逗号分隔)
--attachment否附件路径(多个用逗号分隔)
--is_html否正文是否为 HTML 格式(默认 false)
--from_name否发件人显示名称
示例

发送简单邮件:

bash
python scripts/send_email.py \
  --to friend@example.com \
  --subject "周末聚会" \
  --body "这周末有空吗?一起吃饭吧!"

发送 HTML 邮件带附件:

bash
python scripts/send_email.py \
  --to boss@company.com \
  --subject "项目报告" \
  --body "<h1>项目进度报告</h1><p>详见附件...</p>" \
  --is_html true \
  --attachment "report.pdf,chart.xlsx" \
  --from_name "张三"

发送给多人:

bash
python scripts/send_email.py \
  --to "alice@example.com,bob@example.com" \
  --cc "manager@example.com" \
  --subject "会议纪要" \
  --body "今天的会议纪要如下..."

支持的 SMTP 配置

Gmail
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_USE_TLS=true
Outlook/Hotmail
SMTP_SERVER=smtp-mail.outlook.com
SMTP_PORT=587
SMTP_USE_TLS=true
QQ 邮箱
SMTP_SERVER=smtp.qq.com
SMTP_PORT=587
SMTP_USE_TLS=true
163 邮箱
SMTP_SERVER=smtp.163.com
SMTP_PORT=587
SMTP_USE_TLS=true
企业邮箱(示例)
SMTP_SERVER=smtp.company.com
SMTP_PORT=587
SMTP_USE_TLS=true

常见问题

1. 认证失败

Gmail:

  • 确保启用了两步验证
  • 使用应用专用密码,不是普通密码
  • 检查是否开启了"不够安全的应用"访问(不推荐)

Outlook:

  • 检查是否需要应用密码
  • 确认 SMTP 地址正确
2. 连接超时
  • 检查防火墙设置
  • 尝试端口 465(SSL)代替 587(TLS)
  • 确认 SMTP 服务器地址正确
3. 附件太大
  • Gmail 限制 25MB
  • Outlook 限制 20MB
  • 大文件建议使用云盘链接

安全建议

  1. 永远不要在代码中硬编码密码
  2. 使用环境变量或加密的配置文件
  3. 定期更换应用专用密码
  4. 不要在公共网络使用 SMTP 发送敏感信息

故障排除

运行测试脚本验证配置:

bash
python scripts/test_smtp.py

如果测试失败,检查:

  1. .env 文件配置是否正确
  2. 网络连接是否正常
  3. 邮箱账号密码是否正确
  4. 防火墙是否阻止 SMTP 端口

© openakita, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts) in skills/smtp-email-sender of openakita/openakita.

  • SKILL.md
  • .openakita-i18n.json
  • scripts/configure_smtp.py
  • scripts/send_email.py
  • scripts/test_smtp.py

Open the folder on GitHubat commit 5f5b38d

Compare with similar skills

Smtp Email Sender next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Smtp Email Sender compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Smtp Email Sender this skillopenakita/openakita2k—~693Automated safety check: NotesAGPL-3.0
Deliverability Test Publicgrowthenginenowoslawski/coldoutboundskills753—~1kAutomated safety check: PassMIT
Google Workspaceericrisco/rsc-harness180—~3.2kAutomated safety check: PassMIT
Email Deliverabilityericrisco/rsc-harness180—~2.3kAutomated safety check: PassMIT
Imap Smtp Emailfreestylefly/wesight9463 repos~1.7kAutomated safety check: NotesMIT
Mjml Email TemplatesAaronontheweb/dotnet-skills1.2k1 repos~2.7kAutomated safety check: PassMIT

Similar skills

  • Deliverability Test Public

    growthenginenowoslawski/coldoutboundskills

    Compare reply rates, bounce rates, and positive reply rates broken down by inbox type (SMTP / Gmail / Outlook) for a Smartlead account.

    753 GitHub stars~1k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Google Workspace

    ericrisco/rsc-harness

    A skill your agent uses when server-side code reads or writes Gmail, Drive, Calendar, or Sheets with a GCP service account and no human in the OAuth loop: picking the auth mode (app-owned vs…

    180 GitHub stars~3.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Email Deliverability

    ericrisco/rsc-harness

    A skill your agent uses when mail already sent lands in spam, is rejected, or fails the Gmail/Yahoo bulk-sender checks and the fix is authentication and reputation, not the sending code…

    180 GitHub stars~2.3k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Imap Smtp Email

    freestylefly/wesight

    Read and send email via IMAP/SMTP. An agent skill from freestylefly/wesight.

    946 GitHub starsUsed in 3 repos~1.7k tokens
    Backend & APIsAuto-check: notes
  • Mjml Email Templates

    Aaronontheweb/dotnet-skills

    Build responsive email templates using MJML markup language.

    1.2k GitHub starsUsed in 1 repo~2.7k tokens
    Backend & APIsAuto-check passed
  • Imap Smtp Email

    wentorai/Research-Claw

    Read, search, and manage email via IMAP protocol. An agent skill from wentorai/Research-Claw.

    858 GitHub stars~1.3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check: notes

More from openakita/openakita

All 29 skills in this repo
  • Deliver Artifacts

    openakita/openakita

    Deliver artifacts (files/images/voice) to current IM chat via gateway, returning a receipt.

    2k GitHub stars~288 tokensUpdated 17 days ago
    Auto-check passed
  • Switch Persona

    openakita/openakita

    Switch Agent persona preset. An agent skill from openakita/openakita.

    2k GitHub stars~286 tokensUpdated 17 days ago
    Auto-check passed
  • Toggle Proactive

    openakita/openakita

    Toggle proactive messaging mode. An agent skill from openakita/openakita.

    2k GitHub stars~228 tokensUpdated 17 days ago
    Auto-check passed
  • Browser Task

    openakita/openakita

    Smart browser task agent - describe what you want done in natural language and it completes automatically.

    2k GitHub stars~715 tokensUpdated 17 days ago
    Auto-check passed
  • CLI Anything

    openakita/openakita

    Control desktop software (GIMP, Blender, LibreOffice, etc.) through CLI-Anything generated command-line interfaces.

    2k GitHub stars~507 tokensUpdated 17 days ago
    Auto-check passed
  • Run Shell

    openakita/openakita

    Execute shell commands for system operations, directory creation, and script execution.

    2k GitHub stars~571 tokensUpdated 17 days ago
    Auto-check passed

Works with

Questions about Smtp Email Sender

What does Smtp Email Sender do?

Send emails via SMTP (Gmail, Outlook, etc.). An agent skill from openakita/openakita. Smtp Email Sender is an agent skill from openakita/openakita.).

When should I use Smtp Email Sender?

Smtp Email Sender fits situations like: user asks to send email; tasks that involve Transactional email; tasks that involve Email management.

How do I install Smtp Email Sender in Claude Code?

Run `npx skills add openakita/openakita --skill smtp-email-sender -a claude-code`. Or copy the skill folder (skills/smtp-email-sender in openakita/openakita) into .claude/skills/smtp-email-sender in your project. Claude Code loads it when a task matches its description.

How do I install Smtp Email Sender in Codex?

Run `npx skills add openakita/openakita --skill smtp-email-sender -a codex`. Or copy the skill folder (skills/smtp-email-sender in openakita/openakita) into .agents/skills/smtp-email-sender in your project. Codex loads it when a task matches its description.

Can I use Smtp Email Sender in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add openakita/openakita --skill smtp-email-sender -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/smtp-email-sender, .gemini/skills/smtp-email-sender, .github/skills/smtp-email-sender and .opencode/skills/smtp-email-sender in your project.

What does Smtp Email Sender need to run?

Going by SKILL.md and its folder, Smtp Email Sender needs Python for the scripts in its folder, the command-line tools its instructions call (python) and credentials named SMTP_PASSWORD. Our summary lists: Python 3.

Does Smtp Email Sender access the network?

SKILL.md names 1 domain. As links in the text: account.microsoft.com. This is read from the text; nothing was executed.

Is Smtp Email Sender safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Smtp Email Sender use?

Smtp Email Sender is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Smtp Email Sender use?

About 693 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Smtp Email Sender?

Skills that share tags, products or a category with Smtp Email Sender: Deliverability Test Public (growthenginenowoslawski/coldoutboundskills, 753 stars), Google Workspace (ericrisco/rsc-harness, 180 stars), Email Deliverability (ericrisco/rsc-harness, 180 stars) and Imap Smtp Email (freestylefly/wesight, 946 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Smtp Email Sender?

openakita (a GitHub user) maintains it in openakita/openakita, which has 1,999 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on September 24, 2026.

Source: openakita/openakita on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.