| name | gmail-operations |
| version | 1.0.0 |
| category | email |
| description | Class-level Gmail and email operations: multi-account setup, OAuth, triage, extraction, archiving, attachments, unsubscribe, and touchbase workflows. |
| tags | ["gmail","email","triage","extraction"] |
Gmail Operations
When to Use
Use for Gmail/himalaya setup and recurring inbox operations: triage, extraction to repositories, archive hygiene, attachment/document parsing, unsubscribe sweeps, and relationship touchbase.
Class-Level Workflow
- Confirm account context and OAuth/token health first.
- Use live Gmail/himalaya/API access as the source of truth. Do not treat cached Claude/Hermes tool-result files, old session transcripts, or browser history as evidence of current email state; those are only historical hints.
- If live email access is unavailable, fail closed: say email verification is blocked, name the missing access class, and convert the task into a concrete follow-up checklist rather than implying the inbox was checked.
- Classify mail by action class: triage, extract/archive, attachment processing, unsubscribe, contact/touchbase.
- Preserve source message identifiers in extracted artifacts.
- Keep destructive mail actions batched and reviewable.
Live-Access Pitfall: Coordination Reminders
For appointment/reminder coordination that asks to “check email,” first verify a real mail client/API path is authenticated. Browser Gmail redirects to login, stale MCP result files, or previous session snippets are not sufficient. If blocked, create/update the coordination artifact with explicit checklist items like “check email/portal/texts for confirmation,” and report the email check as blocked rather than silently substituting historical evidence. See references/live-email-source-of-truth.md.
Consolidated Session Learnings
The references/ directory contains archived narrow skills absorbed during the 2026-04-29 umbrella consolidation pass. Use the subsections below as the class-level index, then open the named reference when a case-specific recipe is needed.
Absorbed Narrow Skills (2026-04-29)
gmail-attachment-to-document
- Former skill demoted to
references/gmail-attachment-to-document.md.
- Preserved insight: Download attachments from Gmail threads, parse their content (Excel, PDF), extract structured data, and save to target repos with proper legal scanning.
gmail-data-extraction
- Former skill demoted to
references/gmail-data-extraction.md.
- Preserved insight: Extract structured data from Gmail emails using REST API (no pip dependencies). Covers inbox scanning, subject line regex extraction, email text parsing, thread-aware drafting, and legal-scan-before-commit workflow.
gmail-email-to-repo-extraction
- Former skill demoted to
references/gmail-email-to-repo-extraction.md.
- Preserved insight: Extract structured data from Gmail inbox emails, enrich with domain-specific classification, legal-scan against deny list, commit to appropriate repo, then optionally delete originals.
gmail-extract-and-clean
- Former skill demoted to
references/gmail-extract-and-clean.md.
- Preserved insight: Extract emails from Gmail to /mnt/ace//, archive to appropriate workspace-hub external repos, commit, then delete from inbox. Uses email-routing.yaml for sender→repo routing.
gmail-extract-archive
- Former skill demoted to
references/gmail-extract-archive.md.
- Preserved insight: Extract Gmail data into a structured archive repo, parse attachments, legal scan, then delete from inbox. Single source of truth for all email data across 3 accounts.
gmail-headless-oauth
- Former skill demoted to
references/gmail-headless-oauth.md.
- Preserved insight: Manual OAuth2 token exchange for Gmail on headless servers. Bypass gmail-mcp-multiauth browser requirement. Generate auth URLs, exchange codes, manage multi-account credentials with auto-refresh.
gmail-multi-account
- Former skill demoted to
references/gmail-multi-account.md.
- Preserved insight: Multi-account Gmail management via himalaya CLI. Three accounts (aceengineer, achantav, skestates) with distinct triage rules, contact DBs, and tone profiles. Foundation skill for email automation.
gmail-touchbase
- Former skill demoted to
references/gmail-touchbase.md.
- Preserved insight: Periodic relationship maintenance via email — identify contacts due for outreach, draft personalized check-ins, queue for user approval. Supports per-account tone and cadence.
gmail-triage
- Former skill demoted to
references/gmail-triage.md.
- Preserved insight: Daily multi-account Gmail inbox triage — scan unread, classify by urgency, cross-reference contacts, generate actionable digest. Supports ace/personal/skestates accounts.
gmail-unsubscribe
- Former skill demoted to
references/gmail-unsubscribe.md.
- Preserved insight: Identify and batch-unsubscribe from newsletters and marketing emails across Gmail accounts. Scans List-Unsubscribe headers, generates candidates, executes with user approval.
contact-manager
- Former skill demoted to
references/contact-manager.md.
- Preserved insight: Normalize, classify, and manage contact databases across 3 Gmail accounts. Clean CSV exports, deduplicate, tag categories, flag touchbase/unsubscribe candidates.
