Fast Apple Mail search via SQLite on macOS. Search emails by subject, sender, date, attachments - results in ~50ms vs 8+ minutes with AppleScript.
SkillScore100Maintained
Automatic
◆Personal Assistant pack
Last verified 8/19/2026
What it changes
Passed 23 of 23 test cases with the skill, and 8 of 23 without it.
Without skill35%
With skill100%
Checks it passed that the model alone missed
The command includes the quiet flag.
The command uses the stats subcommand.
The command uses the attachments subcommand.
and 15 more in the full report
15 fixed8 passed either way0 still failing0 broke
Pass-rate lift
+65 pp
Tokens
-12%
Agent turns
0%
Response time
-48%
Model gemini-3.6-flashMeasured 8/19/2026v123 of 23 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
What's inside
The instructions your model reads when the skill loads.
SKILL.md99 linessingle file
Apple Mail Search
Search Apple Mail.app emails instantly via SQLite. ~50ms vs 8+ minutes with AppleScript.
Installation
# Copy mail-search to your PATH
cp mail-search /usr/local/bin/
chmod +x /usr/local/bin/mail-search
Usage
mail-search subject "invoice" # Search subjects
mail-search sender "@amazon.com" # Search by sender email
mail-search from-name "John" # Search by sender name
mail-search to "[email protected]" # Search sent mail
mail-search unread # List unread emails
mail-search attachments # List emails with attachments
mail-search attachment-type pdf # Find PDFs
mail-search recent 7 # Last 7 days
mail-search date-range 2025-01-01 2025-01-31
mail-search open 12345 # Open email by ID
mail-search stats # Database statistics
Options
-n, --limit N Max results (default: 20)
-j, --json Output as JSON
-c, --csv Output as CSV
-q, --quiet No headers
--db PATH Override database path
Create user-facing App Store release notes by collecting and summarizing all user-impacting changes since the last git tag (or a specified ref). Use when asked to generate a comprehensive release changelog, App Store "What's New" text, or release notes based on git history or tags.