Name: Mail
Author: Iván

據 AlphaMoat 統計,截至 2026-09,Mail 累計下載 4,877 次、獲 4 個星標,在全部 5,078 個 AI 技能中排名第 1,920 位,在「辦公效率」分類(435 個)中排名第 172 位。

累計安裝

217

累計下載

4877

星標

全站排名

#1,920

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

平台	累計安裝	累計下載	星標	評論
ClawHub ↗	155	4877	4	-
SkillHub ↗	217	4476	4	—

各平台的計數口徑不同,統計時間不一致。

這個技能是做什麼的

該技能支援讀取、搜尋、篩選和傳送郵件，可按平台使用 Himalaya CLI 或 Apple Mail 資料庫。傳送須遵循草稿、審閱、傳送流程；未經明確確認不刪除郵件，也不會未經使用者審閱自動傳送。Gmail 應用密碼按主文要求儲存在 macOS Keychain 中，技能不會修改憑據。郵件本文和附件可能含敏感資訊；寄送前核對收件人和內容，並保護本機郵件資料庫及匯出檔案。

資料釋出於 2026-10-27

可以用來做什麼

搜尋並篩選郵件
起草回覆或傳送郵件前進行審閱

什麼時候用

使用者希望檢視、查詢或處理郵件時
準備傳送或刪除郵件，需要遵循確認和審閱邊界時

示例提示詞

以下是根據技能文件生成的示例,不代表實際執行結果。

查詢這封郵件並整理一份回覆草稿供我審閱

先列出待傳送郵件內容，等我確認後再傳送

月度資料趨勢

累計下載4877

星標4

2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。

月份	累計下載	環比	星標
2026-09	4877	—	4
2026-08	4432	+6.2%	4
2026-07	4172	+10.1%	4
2026-06	3790	+5.6%	4
2026-05	3590	—	4
2026-03	2781	—	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