Skip to content
Skills Library
Personal productivity · Automation

mail

/mail

Read Mail.app inboxes and create Reminders for actionable items. Use for email triage.

Repository
dotfiles ↗
Licence
MIT
Last repository change
10.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
8
Scripts
3
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 10.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 3 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/extract-attachment.sh, scripts/extract-urls.sh, scripts/reminders-cli.swift

What it does and when to use it

Read Mail.app inboxes and create Reminders for actionable items. Use for email triage.

Original author description

Read Mail.app inboxes and create Reminders for actionable items. Use for email triage.

How it works

  1. Usage
  2. Workflow
  3. Notes
Original SKILL.md headings · 181 lines, 932 words
SKILL.md preview
---
name: mail
description: Read Mail.app inboxes and create Reminders for actionable items. Use for email triage.
---

# Mail Processor

Reads macOS Mail.app, identifies actionable emails, and creates reminders in Reminders.app "Inbox" list.

## Usage

- `/mail` — process past 24 hours (default)
- `/mail 7 days` — process past 7 days
- `/mail 14 days` — process past 14 days

## Workflow

### Batch A: Fetch Everything (PARALLEL)

**Issue ALL of these tool calls in a single parallel message:**

1. **Bash** — Activate apps + fetch emails (combined to avoid extra round-trip):

   ```bash
   osascript -e 'tell application "Mail" to activate' && osascript -e 'tell application "Reminders" to activate' && sleep 1 && osascript ~/.claude/skills/mail/scripts/fetch-mail.applescript <days>
   ```

   - Default `<days>` is 1. If user provides args like "7 days", "48h", or "14 days", extract the number.
   - Returns JSON array. Each email object has: `id`, `account`, `subject`, `from`, `date`, `read`, `preview`.

2. **Read** — Load dedup database from `/tmp/mail-already-processed.json`:
   - If the file does not exist (Read fails/hook blocks), initialize it:
     - **Write** `/tmp/mail-already-processed.json` with: `{"processed_ids":[],"last_run":""}`
     - Then **Read** it

3. **Bash** — Fetch existing reminders for dedup:
   ```bash
   ~/.claude/skills/mail/scripts/reminders-cli fetch
   ```

**After Batch A completes**, filter out emails whose `id` is already in `processed_ids`. Only analyze NEW emails.

### Step B: Analyze Emails for Actionable Items

For each new email, determine if it requires action. Classify into:

**Actionable** (create reminder):

- Explicit deadlines or due dates mentioned
- Meeting invitations requiring RSVP or preparation
- Requests addressed to the user (reply needed, form to fill, document to sign)
- System alerts requiring intervention (server down, config errors, expiring accounts)
- Action items with keywords: "please", "action required", "deadline", "due by", "before", "sign", "submit", "reply", "confirm"

**Not actionable** (skip):

- Newsletters, promotional emails, product announcements
- Read receipts, automated notifications (no action needed)
- Already-read informational emails
- Spam, marketing

For each actionable email, extract:

- **name**: Short task description (not the raw subject — rewrite for clarity)
- **body**: Key details — who sent it, what's needed, any action URLs (see Batch C)
- **due**: Best estimate of deadline in "YYYY-MM-DD HH:MM" format. If no explicit deadline, set reasonable default (e.g., next business day for requests, meeting time for prep)
- **priority**: 1 (high/urgent), 5 (medium/normal), 9 (low/FYI)

### Batch C: Extract URLs (PARALLEL)

**Issue ALL extract-urls.sh calls in a single parallel message** — one Bash tool call per actionable email:

```bash
~/.claude/skills/mail/scripts/extract-urls.sh "<message-id>"
```

Returns one URL per line, filtered to remove tracking pixels, images, and social media links.

**How to use extracted URLs**:

- Include the most relevant action URL in the reminder **body** (e.g., sign-off links, registration URLs, form links)
- If multiple URLs are returned, pick the one most relevant to the required action (e.g., a token/report URL, not the homepage)
- Show actionable URLs in the summary report under a **Link** column

**Performance note**: Only run this for actionable emails (typically 1-5 per batch). Each call takes ~2-3s but they run in parallel, so total wall time ≈ one call.

### Step D: Deduplicate Against Existing Reminders

Before adding, check if a similar reminder already exists (from Batch A's reminders fetch) by comparing:

- Exact or fuzzy match on reminder name
- Same due date
- Similar body content (e.g., same sender + same topic)

Skip any reminder that would be a duplicate.

### Step E: Add Reminders (BATCH)

Use the batch-add command to create all reminders in a single process invocation:

```bash
printf '%s' '<JSON_ARRAY>' | ~/.claude/skills/mail/scripts/reminders-cli batch-add
```

Where `<JSON_ARRAY>` is a JSON array of objects:

```json
[
  {
    "name": "Task title",
    "body": "Details and context",
    "due": "YYYY-MM-DD HH:MM",
    "priority": "1"
  },
  {
    "name": "Another task",
    "body": "More details",
    "due": "YYYY-MM-DD HH:MM",
    "priority": "5"
  }
]
```

Priority values: `"1"` (high/urgent), `"5"` (medium/normal), `"9"` (low/FYI).

Returns `OK:<count>` on success.

**Shell escaping**: The JSON must be valid. Use `printf '%s'` to pipe JSON to stdin. Avoid single quotes inside the JSON — use escaped double quotes for string values.

**Fallback**: If batch-add fails, fall back to individual `reminders-cli add` calls — issue them ALL in a single parallel message:

```bash
~/.claude/skills/mail/scripts/reminders-cli add "<name>" "<body>" "<due_date>" "<priority>"
```

### Step F: Update Dedup Database

After processing, update `/tmp/mail-already-processed.json`:

- Add all newly processed email IDs (both actionable and non-actionable) to `processed_ids`
- Update `last_run` timestamp
- Keep only IDs from the last 30 days to prevent unbounded growth

Use the **Write** tool (not bash heredoc/redirect) to write the updated JSON:

```json
{
  "processed_ids": ["id1", "id2", ...],
  "last_run": "2026-03-10T00:00:00"
}
```

**Important**: Do NOT use `cat > file << EOF` — the `check-file-exists` hook will block the `>` redirect. Always use the Write tool for this file.

### Step G: Report Summary

Present results to user in a table:

```
## Mail Summary (past <N> days)

**Processed**: X new emails across Y accounts
**Skipped**: Z already-processed emails

### Actionable Items Added to Reminders:

| # | Due | Reminder | Priority | Source | Link |
|---|-----|----------|----------|--------|------|
| 1 | 3/9 12:00 | Task name | HIGH | sender@email.com | [action link](url) |

### Non-Actionable (skipped):
- Newsletter from X
- Notification from Y
```

If no actionable URL was found for an item, show "—" in the Link column.

## Notes

- The user's Mail.app has accounts: iCloud, 一般, 正式, 和信, Exchange
- Inbox mailbox names vary: "INBOX" (IMAP) and "收件匣" (Exchange/localized)
- Reminders go to the "Inbox" list in Reminders.app
- Language: emails may be in English, Chinese (Traditional), or Japanese — handle all
- The dedup file at `/tmp/mail-already-processed.json` persists across reboots only if /tmp is not cleaned. This is acceptable — reprocessing is harmless since we also check existing reminders.
Files in this package (8)
  • SKILL.md 6 KB
  • scripts/add-reminder.applescript 1 KB
  • scripts/extract-attachment.sh 3 KB
  • scripts/extract-urls.sh 1 KB
  • scripts/fetch-mail.applescript 4 KB
  • scripts/fetch-reminders.applescript 2 KB
  • scripts/reminders-cli 92 KB
  • scripts/reminders-cli.swift 6 KB

Versions

RepositoryScoreLicence
This page · htlin222/dotfiles100MIT
unsady/den100Apache-2.0

Database snapshot: 13.11.2026 · package version 5a8f6ac97210 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100mail2reminders
    Extract dates and times from Apple Mail messages and create Apple Reminders with alarms. Use when the user asks to scan their email for meetings, deadlines, appointments, or events, to turn email dates into reminders or notifications, or to set up a daily email-to-reminders job…
  • 100mail-triage
    Lists the mail threads that need the user's action, one line each with a proposed outcome (reply, task, waiting or no action), so the user does not read the whole inbox. Read only. Use when the user says "triage my inbox", "what needs my attention in mail", "anything important…
  • 100apple-pim
    Native macOS personal information management for calendars, reminders, contacts, and local Mail.app. Use when the user wants to schedule meetings, create events, check their calendar, create or complete reminders, look up contacts, find someone's phone number or email, manage…
  • 100apple-pim
    Native macOS personal information management for calendars, reminders, contacts, and local Mail.app. Use when the user wants to schedule meetings, create events, check their calendar, create or complete reminders, look up contacts, find someone's phone number or email, manage…
  • 100apple-reminders
    Manage Apple Reminders on macOS using `remindctl` (list, add, edit, complete, delete, and list management). Use when users ask to create reminders, check tasks, mark items done, manage to-do lists, or perform task-list operations in Apple Reminders. Triggers on mentions of…
  • 100macos
    Read or change native macOS apps from the shell — Reminders, Calendar, Notes, Mail, Messages/iMessage, Contacts. Fire whenever a request names or implies one: "remind me to", "what's on my calendar", "text X", "any mail from Y", "make a note", "complete a reminder", "add an…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.