gmail-organizelisted
Install: claude install-skill shawnchiao/gmail-organize-skill
# Gmail Organize
Read `references/pitfalls.md` first. It is short and it is why this works.
## Modes
Ask if unclear. Default **safe**.
- **safe** — nothing deleted or unsubscribed until the user approves the review page.
- **fast** — obvious junk (retail promos, marketing with 20+ messages and an unsubscribe link) proceeds without per-domain approval. Financial, transactional, personal, and low-volume senders still go to review.
## Absolute rules
1. Trash only. Never permanent deletion.
2. Emptying Trash is the user's action. Say so — until they do it, no storage is reclaimed.
3. Never bulk-delete a protected category (`references/protected-senders.md`). Unsure → keep.
4. Every deletion query ends with `-is:starred`.
5. Confirm the unsubscribe batch before firing. It's outbound.
6. Marketing and receipts share domains. Unsubscribe the marketing address; keep the mail.
## Phases
Read `references/playbook.md` at each phase, not up front.
| | Phase | Output |
|---|---|---|
| 1 | Inventory every sender via API, group by registrable domain | `review-data.json` |
| 2 | Generate review page, get decisions | `decisions.json` |
| 3 | Unsubscribe active senders via `List-Unsubscribe` | `unsub-ledger.json` |
| 4 | Batch-delete approved backlog | user empties Trash |
| 5 | Create labels + filters | — |
| 6 | Hand over monthly routine | — |
3 and 4 run in parallel. 5 depends on neither.
## Tool choice
| Task | Use |
|---|---|
| Sender inventory | API, metadata-only view |
| Ex