| name | email-triage |
| description | Email scanning, categorization, and autonomous action pattern — read emails, categorize by type, take action (create tasks/events/bills), and send batched Telegram summary. Use when user says "scan emails", "email triage", "process inbox", "email check", "unread emails", "email actions", "handle emails", or any agent needs to read and act on emails. |
Email Triage Skill
Canonical workflow for scanning, categorizing, and autonomously acting on Gmail emails. Used by heartbeat, daily-briefing, and any agent that needs to process the inbox.
Core Principle
Do NOT just count unread emails. Actually read them and take action. The pattern is: Scan → Read → Categorize → Act → Batch Notify.
Step 1: Scan
gmail_search(query: "is:unread newer_than:3h", maxResults: 20)
Adjust the time window based on agent frequency:
- Heartbeat (every 90 min):
newer_than:3h
- Daily briefing (once/day):
newer_than:24h
- On-demand:
newer_than:7d or specific query
Step 2: Read & Categorize
For EACH email, call gmail_read(messageId) and classify:
| Category | Signal Words / Patterns | Priority |
|---|
| Bills / Payment Due | "amount due", "payment", "statement", invoice, "$XX.XX by [date]" | HIGH |
| Appointments / Scheduling | "confirmed", "reminder", "appointment", "scheduled for" | HIGH |
| Action Items | "please review", "action required", "submit by", "deadline" | HIGH |
|
