automating-mail
Automates Apple Mail via JXA with AppleScript dictionary discovery. Use when asked to "automate email", "send mail via script", "JXA Mail automation", or "filter email messages". Covers accounts, mailboxes, batch message filtering, composition, attachments, and UI fallback.
Third-Party Agent Skill: Review the code before installing. Agent skills execute in your AI assistant's environment and can access your files. Learn more about security
Installation for Agentic Skill
View all platforms →skilz install SpillwaveSolutions/automating-mac-apps-plugin/automating-mailskilz install SpillwaveSolutions/automating-mac-apps-plugin/automating-mail --agent opencodeskilz install SpillwaveSolutions/automating-mac-apps-plugin/automating-mail --agent codexskilz install SpillwaveSolutions/automating-mac-apps-plugin/automating-mail --agent geminiFirst time? Install Skilz: pip install skilz
Works with 14 AI coding assistants
Cursor, Aider, Copilot, Windsurf, Qwen, Kimi, and more...
Extract and copy to ~/.claude/skills/ then restart Claude Desktop
git clone https://github.com/SpillwaveSolutions/automating-mac-apps-plugincp -r automating-mac-apps-plugin/plugins/automating-mac-apps-plugin/skills/automating-mail ~/.claude/skills/Need detailed installation help? Check our platform-specific guides:
Related Agentic Skills
automating-reminders
by SpillwaveSolutions
Automates Apple Reminders using JavaScript for Automation (JXA). Use when asked to "create reminders programmatically", "automate reminder lists", ...
mastering-postgresql
by SpillwaveSolutions
PostgreSQL development for Python with full-text search (tsvector, tsquery, BM25 via pg_search), vector similarity (pgvector with HNSW/IVFFlat), JS...
automating-contacts
by SpillwaveSolutions
Automates macOS Contacts via JXA with AppleScript dictionary discovery. Use when asked to "automate contacts", "JXA contacts automation", "macOS ad...
automating-pages
by SpillwaveSolutions
Automates Apple Pages using JXA with AppleScript dictionary discovery. Use when asked to "automate Pages documents", "create documents programmatic...
Agentic Skill Details
- Owner
- SpillwaveSolutions (GitHub)
- Repository
- automating-mac-apps-plugin
- Stars
- 5
- Forks
- 1
- Type
- Other
- Meta-Domain
- Primary Domain
- Market Score
- 100
Agent Skill Grade
A Score: 100/100 Click to see breakdown
Score Breakdown
Areas to Improve
- PyXA examples longer than JXA equivalents
- Missing error handling in examples
Recommendations
- Add trigger phrases to description for discoverability
- Add table of contents for files over 100 lines
Graded: 2026-01-19
Developer Feedback
I took a look at your automating-mail skill and wanted to share some thoughts.
Links:
The TL;DR
You're at 100/100, full marks. This is based on Anthropic's skill best practices, and honestly, your skill hits the standard across the board. Strongest areas: Spec Compliance (14/15) and Progressive Disclosure Architecture (27/30)—your reference structure is clean, every file has a purpose, and nothing's wasted. Weakest area (still solid): Writing Style (9/10)—mainly because your PyXA examples are a bit more verbose than their JXA equivalents.
What's Working Well
- Reference architecture is chef's kiss. 10 carefully scoped reference files, each one level deep from the main SKILL.md. No navigation bloat, clear "What to load" sections. This is how layered skills should be structured.
- Spec compliance is tight. Valid YAML, correct naming conventions (hyphen-case), good third-person description with solid trigger terms like "JXA Mail automation" and "filter email messages." You nailed the metadata.
- Practical scope boundaries. You've got a clean "When Not to Use" section, which matters because automation tools can get messy. Developers know exactly where this skill ends.
- Examples across three stacks. JXA, PyXA, PyObjC patterns with input/output examples and API reference tables. That's comprehensive coverage for a macOS-specific skill.
The Thing Worth Fixing
PyXA examples are longer than JXA for the same operations. In your mail-recipes.md, the PyXA filter example is 8 lines while the JXA version is basically one line. This ...
AI-Detected Topics
Extracted using NLP analysis
Report Security Issue
Found a security vulnerability in this agent skill?
Report Security Issue
Reporting issue with:
automating-mail
https://github.com/SpillwaveSolutions/automating-mac-apps-pluginThank you for helping keep SkillzWave secure. We'll review your report and take appropriate action.
Note: For critical security issues that require immediate attention, please also email security@skillzwave.ai directly.