email-digest

# Smart Email Digest

Stop drowning in your inbox. This skill scans your unread emails, sorts them into priority categories, and drafts suggested replies for the urgent ones — so you spend 5 minutes reviewing instead of 45 minutes reading.

Run it on a schedule (morning + afternoon) or trigger on-demand whenever your inbox feels overwhelming.

## What You Get

- All unread emails categorized into 4 priority tiers
- Suggested replies drafted for urgent emails
- Newsletter/marketing clutter identified and separated
- Action items extracted from email bodies
- Summary stats (total unread, urgent count, oldest unread age)

## Setup

### Required
- **Email access** — Gmail (via Gmail API/skill) or any email provider your agent can read. The agent needs read access to your inbox and the ability to list unread messages.

### Optional
- **Send access** — If you want the agent to send drafted replies after your approval, it needs send permissions too
- **Delivery channel** — Telegram/Discord for digest delivery, or file output
- **Contact context** — If you have a CRM or contact list, tell the agent where it is. This helps it prioritize emails from important contacts.

### Configuration

Tell your agent:

1. **Email account** — which inbox to scan
2. **VIP list** — email addresses or domains that are always high priority (your boss, top clients, family)
3. **Mute list** — senders to always categorize as low priority (newsletters you don't read, automated notifications)
4. **Digest schedule** — when to run (default: 8:00 AM and 2:00 PM local)
5. **Delivery** — where to send the digest
6. **Reply style** — how you write emails (professional, casual, direct, friendly) so drafted replies match your voice
7. **Max emails to process** — limit per run (default: 50)

## How It Works

### Step 1: Scan Inbox
- Fetch all unread emails (up to configured max)
- For each email, extract: sender, subject, date received, body preview (first 200 chars), any attachments

### Step 2: Categorize...