$npx -y skills add sales-skills/sales --skill sales-airmailAirmail platform help — Apple-exclusive email client with customizable swipe actions, multi-step Custom Actions, Smart Inbox, Send Later, snooze, AppleScript automation, Siri Shortcuts, Objective-C plugin framework, S/MIME and GPG encryption, Privacy Mode with local-only processi
| 1 | # Airmail Platform Help |
| 2 | |
| 3 | Helps with Airmail — an Apple-exclusive email client for Mac, iPhone, iPad, Apple Watch, and Apple Vision Pro. Known for deep customization (swipe actions, Custom Actions, keyboard shortcuts), Smart Inbox filtering, Send Later scheduling, snooze, S/MIME/GPG encryption, and Privacy Mode (local processing, tracking pixel blocking). Supports Gmail, Exchange, Outlook, iCloud, IMAP, POP3. Apple Design Award winner. No public REST API — automation via AppleScript (Mac), Siri Shortcuts (iOS), URL schemes, and an Objective-C plugin framework. |
| 4 | |
| 5 | ## Step 1 — Gather context |
| 6 | |
| 7 | If `references/learnings.md` exists, read it first for accumulated platform knowledge. |
| 8 | |
| 9 | Ask the user: |
| 10 | |
| 11 | 1. **What are you trying to do with Airmail?** |
| 12 | - A) Set up Airmail and configure Smart Inbox / Custom Actions |
| 13 | - B) Fix crashes, sync issues, or performance problems |
| 14 | - C) Compare Airmail to other email clients |
| 15 | - D) Automate Airmail with AppleScript, Siri Shortcuts, or plugins |
| 16 | - E) Evaluate Airmail Pro vs free tier |
| 17 | - F) Something else — describe it |
| 18 | |
| 19 | 2. **Which device(s)?** |
| 20 | - A) Mac |
| 21 | - B) iPhone / iPad |
| 22 | - C) Apple Watch |
| 23 | - D) Multiple Apple devices |
| 24 | |
| 25 | 3. **Which plan?** |
| 26 | - A) Free — 1 account, basic features |
| 27 | - B) Pro (~$9/mo or ~$49/yr) — multiple accounts, Send Later, Snooze, Custom Actions, push notifications |
| 28 | - C) Not sure / evaluating |
| 29 | |
| 30 | **Skip-ahead rule**: if the user's prompt already provides enough context, skip to Step 2. |
| 31 | |
| 32 | ## Step 2 — Route or answer directly |
| 33 | |
| 34 | | If the question is about... | Route to... | |
| 35 | |---|---| |
| 36 | | Cross-platform email (need Windows/Android) | `/sales-bluemail {question}` or `/sales-em-client {question}` | |
| 37 | | Team shared inbox with ticketing | `/sales-hiver {question}` or `/sales-missive {question}` | |
| 38 | | Server-side email filtering without switching clients | `/sales-sanebox {question}` | |
| 39 | | AI-powered email triage/drafting | `/sales-superhuman {question}` or `/sales-fyxer {question}` | |
| 40 | | Connecting tools via Zapier/Make/API | Note: Airmail has no REST API or iPaaS integration | |
| 41 | |
| 42 | For Airmail-specific questions, continue to Step 3. |
| 43 | |
| 44 | ## Step 3 — Airmail platform reference |
| 45 | |
| 46 | **Read `references/platform-guide.md`** for the full platform reference — capabilities, pricing, customization options, automation surface (AppleScript, Siri Shortcuts, plugins), encryption setup, and integration details. |
| 47 | |
| 48 | Answer the user's question using only the relevant section. Don't dump the full reference. |
| 49 | |
| 50 | ## Step 4 — Actionable guidance |
| 51 | |
| 52 | - For **Custom Actions setup**: Create multi-step actions in Settings → Custom Actions. Chain operations: e.g., "Label as Client + Forward to assistant + Archive." Assign to swipe gestures for one-tap execution. |
| 53 | - For **sync issues**: Sign out and re-add the account. Ensure iCloud sync is enabled for settings. Check that push notifications are on (Pro only). Force close and reopen the app. |
| 54 | - For **AppleScript automation**: Use Airmail's AppleScript dictionary on Mac. Common actions: send email, move messages, search inbox. Combine with Automator or Shortcuts app for scheduled workflows. |
| 55 | - For **plugin development**: Clone the AirmailPlugIn-Framework from GitHub. Plugins are Objective-C bundles inheriting from AMPlugin. Copy built bundles to `~/Library/Containers/it.bloop.airmail/Data/Library/Application Support/Airmail/General/Plugins`. |
| 56 | |
| 57 | If you discover a gotcha, workaround, or tip not covered in `references/learnings.md`, append it there. |
| 58 | |
| 59 | ## Gotchas |
| 60 | |
| 61 | > *Best-effort from research — review these, especially items about plan-gated features and stability that may be outdated.* |
| 62 | |
| 63 | - **Push notifications require Pro.** Free users who previously had push from the one-time purchase era lost it when Airmail switched to subscriptions. This is the most complained-about change. |
| 64 | - **Apple ecosystem only.* |