Name: Mail
Author: Iván

据 AlphaMoat 统计,截至 2026-09,Mail 累计下载 4,877 次、获 4 个星标,在全部 5,078 个 AI 技能中排名第 1,920 位,在「办公效率」分类(435 个)中排名第 172 位。

累计安装

217

累计下载

4,877

星标

全站排名

#1,920

全站前 38% · 「办公效率」前 40%

平台	累计安装	累计下载	星标	评论
ClawHub ↗	155	4,877	4	-
SkillHub ↗	217	4,476	4	—

各平台的计数口径不同,统计时间不一致。

这个技能是做什么的

该技能支持读取、搜索、筛选和发送邮件，可按平台使用 Himalaya CLI 或 Apple Mail 数据库。发送须遵循草稿、审阅、发送流程；未经明确确认不删除邮件，也不会未经用户审阅自动发送。Gmail 应用密码按主文要求存储在 macOS Keychain 中，技能不会修改凭据。邮件正文和附件可能含敏感信息；发送前核对收件人和内容，并保护本地邮件数据库及导出文件。

资料发布于 2026-10-27

可以用来做什么

搜索并筛选邮件
起草回复或发送邮件前进行审阅

什么时候用

用户希望查看、查找或处理邮件时
准备发送或删除邮件，需要遵循确认和审阅边界时

示例提示词

以下是根据技能文档生成的示例,不代表实际运行结果。

查找这封邮件并整理一份回复草稿供我审阅

先列出待发送邮件内容，等我确认后再发送

月度数据趋势

累计下载4,877

星标4

2026-09 起统计方法调整:同名技能按作者分别统计,并覆盖全部技能。图中虚线为调整前的月份,与之后的数据不直接比较,也不计算跨越调整的增长。

月份	累计下载	环比	星标
2026-09	4,877	—	4
2026-08	4,432	+6.2%	4
2026-07	4,172	+10.1%	4
2026-06	3,790	+5.6%	4
2026-05	3,590	—	4
2026-03	2,781	—	4

SKILL.md 原文

以下是作者发布的原始文件,按纯文本显示,本站未做修改或审核;其中的链接不可点击,命令请核实后再运行。抓取于 2026-10-23。

2.8 KB · ClawHub v1.2.0

---
name: Mail
slug: mail
version: 1.2.0
description: Execute email operations with platform-specific optimizations and secure credential handling.
changelog: Added explicit scope, requirements, and data access documentation
metadata: {"clawdbot":{"emoji":"📧","requires":{"bins":["himalaya"]},"os":["darwin","linux"]}}
---

## Requirements

展开全部(共 77 行)


**Binaries:**
- `himalaya` - IMAP/SMTP CLI (`brew install himalaya` or `cargo install himalaya`)
- `osascript` - macOS only, built-in

**Credentials:**
- App Password for Gmail (not regular password), stored in macOS Keychain
- Configure in `~/.config/himalaya/config.toml`

## Data Access

**Read-only paths:**
- `~/Library/Mail/V*/MailData/Envelope Index` - Apple Mail SQLite database (macOS only)
- `~/Library/Mail/V*/MAILBOX/Messages/` - attachment files (macOS only)

## Scope

This skill:
- ✅ Reads email via himalaya CLI or Apple Mail SQLite
- ✅ Sends email via himalaya (draft-review-send workflow)
- ✅ Searches and filters messages
- ❌ NEVER modifies credentials
- ❌ NEVER deletes emails without explicit confirmation
- ❌ NEVER auto-sends without user review

## Quick Reference

| Topic | File |
|-------|------|
| Apple Mail SQLite queries | `apple-mail.md` |
| himalaya CLI patterns | `himalaya.md` |
| Send/reply protocol | `sending.md` |

## Core Rules

### 1. Platform Detection
- **macOS with Apple Mail**: Use SQLite queries (100x faster than AppleScript)
- **Cross-platform**: Use himalaya CLI for full IMAP/SMTP
- **Never mix approaches** in same task - commit to one to avoid state conflicts

### 2. Apple Mail SQLite
- Query path: `~/Library/Mail/V*/MailData/Envelope\ Index`
- **Force sync first**: `osascript -e 'tell app "Mail" to check for new mail'` - SQLite reads stale data otherwise
- Recent mail filter: `WHERE date_received > strftime('%s','now','-7 days')`
- Join `messages→addresses` on `message_id` for sender lookup

### 3. himalaya CLI
- **Always use**: `--output json` flag for programmatic parsing
- List emails: `himalaya envelope list -o json` (NOT `message list`)
- Folder names are case-sensitive
- Run `himalaya folder list` after server-side folder changes

### 4. Send Protocol
- **Draft-review-send workflow**: Compose → show user full content → send after explicit OK
- Reply threading: Include `In-Reply-To` and `References` headers or thread breaks
- Some SMTP servers reject if From header doesn't match authenticated user

### 5. Credential Management
- macOS Keychain: `security add-internet-password -s imap.gmail.com -a [email protected] -w 'app-password'`
- Gmail/Google Workspace: Requires App Password with 2FA enabled
- OAuth: himalaya supports XOAUTH2 via token_cmd in config.toml

### 6. Thread Intelligence
- Thread by `In-Reply-To` chain, not subject matching
- "Re:" prefix is unreliable
- Polling intervals: 15-30 min max; use `himalaya envelope watch` for real-time