Agent skill

Email Ops Skill

by OpenLoaf in OpenLoaf/OpenLoaf

当用户要对真实电子邮件账户做任何操作时触发:查收件箱、读信、回复、转发、撰写、发送、搜索、归档、删除。典型说法"查下我邮箱"、"xx 给我发了啥"、"check my inbox"。不用于:即时消息 / IM / 微信 / Slack、翻译含"邮件"二字的文本、对 .eml 文件做离线解析(→直接用 Read)。

AGPL-3.0Auto-check passedProductivity & Automation

Install Email Ops Skill

skills CLI
$ npx skills add OpenLoaf/OpenLoaf --skill email-ops-skill -a claude-code

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

GitHub CLI
$ gh skill install OpenLoaf/OpenLoaf email-ops-skill --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/OpenLoaf/OpenLoaf.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/server/src/ai/builtin-skills/email-ops .claude/skills/email-ops-skill && 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
email-ops-skill
GitHub stars
108
Token cost
~901 tokens
SKILL.md length
173 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
AGPL-3.0

At a glance

当用户要对真实电子邮件账户做任何操作时触发:查收件箱、读信、回复、转发、撰写、发送、搜索、归档、删除。典型说法"查下我邮箱"、"xx 给我发了啥"、"check my inbox"。不用于:即时消息 / IM / 微信 / Slack、翻译含"邮件"二字的文本、对 .eml 文件做离线解析(→直接用 Read)。

  • Works in 3 steps: get-message 获取原邮件完整内容 → 构造新邮件:to 填转发目标,subject 加 Fwd:… → 用纯文本展示完整转发邮件让用户确认后 send
  • Tasks that involve Email management
  • SKILL.md covers 工具清单, 我该用哪个查询模式?, 核心工作流 and 转发邮件, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Email Ops Skill is an agent skill from OpenLoaf/OpenLoaf. 当用户要对真实电子邮件账户做任何操作时触发:查收件箱、读信、回复、转发、撰写、发送、搜索、归档、删除。典型说法"查下我邮箱"、"xx 给我发了啥"、"check my inbox"。不用于:即时消息 / IM / 微信 / Slack、翻译含"邮件"二字的文本、对 .eml 文件做离线解析(→直接用 Read)。

Its SKILL.md is about 900 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Email management. It works with Slack. The repository describes itself as: 🍞Open-source, local-first AI workspace with Agents, multi-model chat (GPT/Claude/Gemini/DeepSeek), Notion-like docs, AI image & video generation, email, calendar & terminal…. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Email management

Example prompts

  • “xx 给我发了啥”
  • “check my inbox”
  • “/email-ops-skill”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. get-message 获取原邮件完整内容
  2. 构造新邮件:to 填转发目标,subject 加 Fwd: 前缀,bodyText 包含原邮件内容(添加 "---------- Forwarded message ----------" 分隔头和原始发件人/日期/主题信息)
  3. 用纯文本展示完整转发邮件让用户确认后 send

What it can do on your machine

Read from SKILL.md and the folder at commit f7eccf6. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Email Ops Skill loads about 901 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 173 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenLoaf/OpenLoaf at commit f7eccf6, republished under its AGPL-3.0 licence (© OpenLoaf). 173 words, ~901 tokens.

Download SKILL.mdSave it as .claude/skills/email-ops-skill/SKILL.md (or your agent's skills folder).
name
email-ops-skill
description
当用户要对真实电子邮件账户做任何操作时触发:查收件箱、读信、回复、转发、撰写、发送、搜索、归档、删除。典型说法"查下我邮箱"、"xx 给我发了啥"、"check my inbox"。**不用于**:即时消息 / IM / 微信 / Slack、翻译含"邮件"二字的文本、对 .eml 文件做离线解析(→直接用 Read)。
tools
EmailQuery, EmailMutate

邮件操作技能

工具清单

工具职责只读
EmailQuery查询邮箱账号 / 邮件 / 统计 / 搜索(mode: list-accounts / list-unified / list-messages / get-message / search / unread-stats / list-mailboxes)是
EmailMutate发送 / 回复 / 转发 / 归档 / 删除 / 移动邮件(send / delete / move 需审批)否

加载:全部为 deferred 工具,调用前须先 ToolSearch(names: "EmailQuery,EmailMutate") 激活 schema。

我该用哪个查询模式?

按你的目的选择——不要盲猜:

想知道有多少未读?          → unread-stats
想看统一收件箱?            → list-unified (scope: all-inboxes)
想看已发送/草稿/星标?      → list-unified (scope: sent/drafts/flagged)
想在特定邮箱文件夹里翻邮件? → list-messages (需要 accountEmail + mailbox)
想按关键词/发件人搜索?     → search (query 支持自然语言)
想读一封邮件的完整正文?    → get-message (需要 messageId)
不知道用户配了哪些邮箱账户? → list-accounts(永远先调这个来获取 accountEmail)
需要知道有哪些文件夹?      → list-mailboxes

所有列表模式支持 cursor + pageSize(1-50) 分页。

核心工作流

流程一:查看并回复邮件
1. list-accounts                → 拿到可用的 accountEmail
2. list-unified (all-inboxes)   → 看收件箱概览
3. get-message (messageId)      → 读取需要回复的那封邮件完整内容
4. 草拟回复
5. ⚠️ 用纯文本把草稿(收件人 / 主题 / 正文)展示给用户,并明确询问"是否发送",等用户回复确认
6. send (带 inReplyTo + references) → 用户确认后才发送

第 5 步为什么必须做? 因为邮件一旦发出就无法撤回。发错人、写错内容可能造成不可逆的尴尬甚至商业损失。永远让用户亲眼确认收件人、主题和正文后再发送。

第 6 步为什么必须带 inReplyTo? 因为不带它,回复会在收件人邮箱里变成一封独立新邮件,脱离原始对话线程。所有主流邮件客户端(Gmail、Outlook、Apple Mail)都依赖 Message-ID 头来组织会话。inReplyTo 填原邮件的 messageId,references 填原邮件的 references 链 + 原邮件 messageId。

流程二:撰写新邮件
1. list-accounts                → 确认从哪个账户发
2. 根据用户意图草拟邮件
3. ⚠️ 用纯文本展示完整邮件(收件人 / 主题 / 正文)并明确询问"是否发送",等用户回复确认
4. send                         → 确认后发送
流程三:搜索并批量整理
1. search (query: "newsletter")  → 找到所有匹配邮件
2. 向用户汇报搜索结果摘要
3. batch-move / batch-delete     → 按用户指示批量操作

大结果集处理:搜索可能返回大量结果。遵循以下原则:

  • 先用 pageSize: 20 获取第一页,向用户汇报总数和样本
  • 让用户确认操作范围后再批量执行,避免误操作
  • 分批处理(每批不超过 50 条),每批操作间向用户汇报进度
  • 警惕误判:搜索结果可能包含不相关邮件(如搜 "newsletter" 可能匹配到正文提及 newsletter 的正常邮件)。批量删除前务必让用户审核样本
流程四:每日邮件摘要
1. unread-stats                  → 快速了解各账户未读量
2. list-unified (all-inboxes, pageSize: 20) → 获取最新邮件列表
3. 对重要邮件逐一 get-message    → 读取详情
4. 生成结构化摘要(按紧急度/发件人分组)

转发邮件

转发邮件没有独立的 forward 动作,使用 send 实现:

  1. get-message 获取原邮件完整内容
  2. 构造新邮件:to 填转发目标,subject 加 Fwd: 前缀,bodyText 包含原邮件内容(添加 "---------- Forwarded message ----------" 分隔头和原始发件人/日期/主题信息)
  3. 用纯文本展示完整转发邮件让用户确认后 send

附件说明

当前版本不支持邮件附件的发送和下载。如果用户要求:

  • 发送附件 → 告知"当前版本不支持通过 AI 发送邮件附件,建议通过邮件客户端(如 Gmail、Outlook)直接操作"
  • 下载附件 → 同上,引导用户在邮件客户端中操作

邮件格式说明

send 动作的 bodyText 参数为纯文本格式,不支持 HTML。如果用户要求富文本格式(加粗、图片、表格等),告知当前仅支持纯文本,复杂格式建议在邮件客户端中编辑。

常见错误——你必须避免

  1. 发邮件前没让用户文字确认:这是最严重的错误。永远不要自作主张发送邮件,必须先在回复里展示完整草稿并等待用户回复"发送"。
  2. 回复邮件没设 inReplyTo:线程会断裂,收件人看到的是孤立的新邮件。
  3. 不知道 accountEmail 就瞎调:很多操作需要 accountEmail。如果不确定,先 list-accounts。
  4. 把密码、密钥、凭证写进邮件正文:永远不要这样做。
  5. 回复时忘记带 Re: 前缀:subject 应保持 Re: 原主题 格式以维持线程显示。
  6. 转发时忘记带 Fwd: 前缀:subject 应保持 Fwd: 原主题 格式。
  7. 批量操作前未让用户确认样本:大批量删除/移动前必须展示样本,防止误删重要邮件。

操作速查

EmailQuery 7 种模式:list-accounts · list-mailboxes · list-messages · list-unified · get-message · search · unread-stats

EmailMutate 8 种动作:send · mark-read · flag · delete · move · batch-mark-read · batch-delete · batch-move

发送相关参数(send):需要 accountEmail、to、subject、bodyText;回复额外需要 inReplyTo、references。具体参数见工具 schema。

© OpenLoaf, 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

Just SKILL.md in apps/server/src/ai/builtin-skills/email-ops of OpenLoaf/OpenLoaf.

Open the folder on GitHubat commit f7eccf6

Compare with similar skills

Email Ops Skill 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.

Email Ops Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Email Ops Skill this skillOpenLoaf/OpenLoaf108—~901Automated safety check: PassAGPL-3.0
Connect Apps with ComposioComposioHQ/awesome-claude-skills77k3 repos~557Automated safety check: PassNone
Composio Cloud Toolsquarqlabs/argus277—~543Automated safety check: PassApache-2.0
Inbox Archiveyc-software/recruiting116—~1.2kAutomated safety check: NotesNone
Company Brain Follow Up Agenttopoteretes/cognee32k—~779Automated safety check: NotesApache-2.0
Ak Dev New Messaging Integrationyaalalabs/agent-kernel191—~4.2kAutomated safety check: PassApache-2.0

Similar skills

  • Connect Apps with Composio

    ComposioHQ/awesome-claude-skills

    Connects an agent to 1000+ external apps through the Composio Tool Router plugin, so it can actually send emails, create issues and post messages instead of only drafting them.

    77k GitHub starsUsed in 3 repos~557 tokens
    Productivity & AutomationAuto-check passed
  • Composio Cloud Tools

    quarqlabs/argus

    Routes requests to external SaaS apps such as GitHub, Gmail, Google Calendar, Slack, Notion and Linear through cloud tools, with safeguards on irreversible actions.

    277 GitHub stars~543 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Inbox Archive

    yc-software/recruiting

    Suggest inbox emails that are "complete" and safe to archive.

    116 GitHub stars~1.2k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check: notes
  • Turn your latest Granola call into next steps (owner, team, due date, and the Linear issue that already tracks each one) and post them to Slack, using cognee memory of your calls, Linear issues and…

    32k GitHub stars~779 tokensUpdated yesterday
    Productivity & AutomationAuto-check: notes
  • Ak Dev New Messaging Integration

    yaalalabs/agent-kernel

    Step-by-step guide for adding a new messaging platform integration to Agent Kernel.

    191 GitHub stars~4.2k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Caspian Inbox

    TryCaspian/caspian-sdk

    Caspian Inbox (caspian:Inbox) — list agent email and other configured channel conversations/messages.

    973 GitHub stars~347 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed

More from OpenLoaf/OpenLoaf

All 33 skills in this repo
  • Agent Orchestration Skill

    OpenLoaf/OpenLoaf

    Triggers when the master Agent faces a multi-step complex task and is deciding whether / how to outsource sub-tasks to built-in subagents (browser / doc-editor / data-analyst / extractor /…

    108 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Browser Ops Skill

    OpenLoaf/OpenLoaf

    Triggered when the user asks for page-level interaction with a specific webpage: login, form filling, button clicks, pagination scraping, screenshots, downloading page images, handling CAPTCHAs or…

    108 GitHub stars~1.5k tokensUpdated 4 mo ago
    Auto-check passed
  • Canvas Ops Skill

    OpenLoaf/OpenLoaf

    Triggered when the user wants lifecycle management of OpenLoaf canvases / whiteboards: create, open, filter, duplicate, delete, rename, or change ownership.

    108 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Reads, edits, converts and reviews Word documents through three dedicated tools, covering tracked changes, comments, tables, images and format conversion.

    108 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Email Operations

    OpenLoaf/OpenLoaf

    Handles a real email account through query and mutate tools: check the inbox, read, search, reply, forward, compose and organize, with sending always confirmed first.

    108 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check passed
  • macOS Desktop Control

    OpenLoaf/OpenLoaf

    Guides an agent to operate native macOS apps by surveying an app first, acting through intents, menus or keystrokes, and verifying each step, in OpenLoaf Desktop only.

    108 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Questions about Email Ops Skill

What does Email Ops Skill do?

当用户要对真实电子邮件账户做任何操作时触发:查收件箱、读信、回复、转发、撰写、发送、搜索、归档、删除。典型说法"查下我邮箱"、"xx 给我发了啥"、"check my inbox"。不用于:即时消息 / IM / 微信 / Slack、翻译含"邮件"二字的文本、对 .eml 文件做离线解析(→直接用 Read)。. Email Ops Skill is an agent skill from OpenLoaf/OpenLoaf.

When should I use Email Ops Skill?

Email Ops Skill fits situations like: tasks that involve Email management.

How do I install Email Ops Skill in Claude Code?

Run `npx skills add OpenLoaf/OpenLoaf --skill email-ops-skill -a claude-code`. Or copy the skill folder (apps/server/src/ai/builtin-skills/email-ops in OpenLoaf/OpenLoaf) into .claude/skills/email-ops-skill in your project. Claude Code loads it when a task matches its description.

How do I install Email Ops Skill in Codex?

Run `npx skills add OpenLoaf/OpenLoaf --skill email-ops-skill -a codex`. Or copy the skill folder (apps/server/src/ai/builtin-skills/email-ops in OpenLoaf/OpenLoaf) into .agents/skills/email-ops-skill in your project. Codex loads it when a task matches its description.

Can I use Email Ops Skill 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 OpenLoaf/OpenLoaf --skill email-ops-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/email-ops-skill, .gemini/skills/email-ops-skill, .github/skills/email-ops-skill and .opencode/skills/email-ops-skill in your project.

What does Email Ops Skill need to run?

SKILL.md names no scripts, command-line tools or credentials: Email Ops Skill is instructions for the agent only.

Does Email Ops Skill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Email Ops Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Email Ops Skill use?

Email Ops Skill 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 Email Ops Skill use?

About 901 tokens (SKILL.md is roughly 3.6k 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 Email Ops Skill?

Skills that share tags, products or a category with Email Ops Skill: Connect Apps with Composio (ComposioHQ/awesome-claude-skills, 77k stars), Composio Cloud Tools (quarqlabs/argus, 277 stars), Inbox Archive (yc-software/recruiting, 116 stars) and Company Brain Follow Up Agent (topoteretes/cognee, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Email Ops Skill?

OpenLoaf (a GitHub organization) maintains it in OpenLoaf/OpenLoaf, which has 108 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on May 14, 2026.

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