Inbox Cleanup Skill

Inbox Cleanup Skill

A playbook for large-scale email inbox cleanup. The core insight: sender-based scans are low-recall. Subject/body pattern queries catch 25x more archivable email. This skill is a multi-pass pipeline built around that insight.

Works with any connected email provider. Adapt query syntax to whatever the provider supports — the strategy (what to search for, how to decide what to archive) is universal.

Gmail is a required integration. It's declared via includes: ["gmail"] in the frontmatter so it loads synchronously on activation, not lazily after the preferences form. Load/confirm the Gmail integration the moment this skill activates — before Phase 1 — so a missing or unauthorized connection surfaces up front rather than mid-cleanup.

Phase 1: Preference Capture

Do this before touching anything. Ask the user:

1. Aggressiveness level

• Conservative — newsletters with unsubscribe headers + obvious spam only
• Standard — above + cold outreach heuristics (subject patterns, unknown senders)
• Aggressive — above + anything from senders with no prior thread history

2. Age threshold Archive everything older than X days? Common choices: 30 / 60 / 90 days. Or no age filter.

First-run scope: On first invocation, scope to last 30 days or top 3 noise patterns, whichever surfaces faster. Show result, offer to expand. Prove the approach on a fast, visible slice before draining the whole backlog.

3. VIP senders to protect Ask: "Are there any senders that might look like cold outreach but you actually care about? Think: specific individuals at investors, advisors, your lawyer, accountant, recruiters you're actively working with."

Build an explicit keep list. Do not archive anything matching it, ever, regardless of aggressiveness.

4. Categories to confirm before archiving These need a sample + explicit approval before bulk action:

• Financial/billing alerts
• Legal/contracts
• Account suspension notices
• Government/regulatory