ABOUTME: Gmail inbox triage - classify unread by priority, suggest actions

ABOUTME: P1-P4 priority system with CLI tool for classification and batch archival

Inbox Triage Skill

Gmail: See ../_GMAIL.md for account config and commands.

Workflow

Step 1: Classify Inbox

Pipe gog search output through the CLI tool:

gog gmail search "is:unread in:inbox" --json --max=30 --account=maroffo@gmail.com \
  | uv run --project ~/.claude/skills/inbox-triage -- inbox-triage classify

This outputs a markdown summary grouped by priority and saves state to /tmp/inbox-triage-state.json.

Step 2: Review with User

Present the CLI output to the user. The summary includes:

• P1 - Urgent: Direct messages from known contacts, time-sensitive
• P2 - Important: Work-related, newsletters worth reading, personal correspondence
• P3 - Normal: General updates, notifications
• P4 - Low Priority: Promotions, social, automated noise

Step 3: Archive

Use the archive subcommand for batch operations:

# Dry run (shows commands without executing)
uv run --project ~/.claude/skills/inbox-triage -- inbox-triage archive p3 p4

# Execute
uv run --project ~/.claude/skills/inbox-triage -- inbox-triage archive p3 p4 --yes

Step 4: Handle Remaining Items

For P1/P2 threads that need action:

# Open in browser
gog gmail url <threadId>

# Star for follow-up
gog gmail thread modify <threadId> --account=maroffo@gmail.com --add=STARRED

# Mark as read without archiving
gog gmail thread modify <threadId> --account=maroffo@gmail.com --remove=UNREAD

Classification Rules

Rules are in ~/.claude/skills/inbox-triage/rules.yaml (user-editable). First match wins:

1. Sender exact email match
2. Sender domain match (@domain.com)
3. Gmail label match
4. Gmail category fallback (CATEGORY_PROMOTIONS, etc.)
5. Default (P3)

Rules

1. Summarize first - don't read full content unless asked
2. Respect privacy - don't read personal emails in detail without permission
3. Batch operations - group similar actions (archive all promos, etc.)
4. Confirm destructive actions - always confirm before trash/delete
5. Open in browser - use gog gmail url <threadId> for user to read full email