spark-recipe-multi-account-review — Claude Code skill: setup & use

---
name: spark-recipe-multi-account-review
description: >-
  Review inbox status across multiple email accounts with per-account
  breakdown and cross-account priorities.
metadata:
  version: 1.0.0
  requires:
    skills:
      - use-spark
    accessLevel: read-only
---

# Recipe: Multi-Account Review

For users with multiple email accounts, review each account's inbox status and present a unified summary with per-account breakdown.

**Prerequisite:** Read the `use-spark` base skill for command reference and filter syntax.

**Access level required:** read-only.

## Steps

### Step 1: Discover all accounts

```bash
spark accounts
```

Note each account email, its access level, and associated calendars and teams.

### Step 2: Check folders per account

For each account, see the folder structure and message counts:

```bash
spark folders [email protected]
spark folders [email protected]
spark folders [email protected]
```

### Step 3: Review unread mail per account

For each account, check unread across key categories:

```bash
spark emails [email protected] --filter "is:unread"
spark emails [email protected] --filter "is:unread"
spark emails [email protected] --filter "is:unread"
```

For a category-level breakdown on the most active account:

```bash
spark emails [email protected] --filter "category:priority is:unread"
spark emails [email protected] --filter "category:personal is:unread"
```

### Step 4: Cross-account priority check

Check priority mail across all accounts at once:

```bash
spark emails Inbox --filter "category:priority is:unread"
```

This uses the unified inbox to surface priority items regardless of which account received them.

### Step 5: Present the summary

Report per account:
- **[email protected]:** N unread (X priority, Y people)
- **[email protected]:** M unread
- **[email protected]:** K unread

Highlight cross-account priorities and any account that needs immediate attention.

## Tips

- Start with `spark accounts` to discover all configured accounts and their access levels.
- The unified inbox (`spark emails Inbox`) aggregates across all accounts - use it for cross-account priority checks.
- Per-account browsing (`spark emails [email protected]`) keeps things separated when the user wants to focus on one context.
- Use `spark folders <account>` to understand each account's folder structure before browsing specific folders.
- Some accounts may be read-only while others have triage access. `accounts` shows the access level for each.
- For users with work + personal accounts, suggest processing them separately to maintain mental context.
- Combine with `recipe-inbox-by-category` for a deep dive into the most active account.