gmail-report-claude

Gmail-first reporting skill suite. Analyzes inbox activity by day, week, month, year, or custom date range with flexible filters for unread messages, spam inclusion, labels, categories, senders, attachments, and response behavior. Generates structured reports in Markdown or PDF. Use when user says "gmail", "report", "inbox", "email", "unread", "spam", "senders", "labels", "response time", "trends", or any Gmail reporting request.

Inbox organization advisor. Detects unlabeled emails, clusters them by sender, domain, subject pattern, and content type, then suggests a complete label taxonomy with Gmail filter rules. Prescriptive counterpart to gmail-labels (which is descriptive). Supports --pdf and --pt (Portuguese).

Attachment analysis skill. Reports on attachment-heavy traffic, large-file patterns, file type distribution, and periods with high file volume.

Gmail category analysis. Breaks down email across Primary, Promotions, Social, Updates, and Forums tabs to measure inbox composition.

Custom date-range reports with mixed filters. Supports arbitrary start/end dates combined with any filter flags for fully flexible reporting.

Label distribution analysis. Breaks down email volume by Gmail labels to show how the inbox is organized and which labels receive the most traffic.

Resolves time period arguments (today, week, month, year, custom date range) into concrete start and end dates for Gmail data queries.

Markdown report generator. Takes analyzed data and produces a structured, well-formatted Markdown report suitable for Claude Code output, documentation, internal notes, and quick sharing.

Professional PDF report generator. Creates a branded, chart-rich PDF with cover page, KPI tables, trend charts, sender rankings, and actionable recommendations. Ideal for client delivery and archival.

Full Gmail inbox report orchestration. Coordinates data collection, filtering, parallel analysis via subagents, score calculation, and final report generation. This is the main entry point for comprehensive inbox reports.

Response time analysis. Estimates reply latency, identifies fastest and slowest response windows, detects conversations needing follow-up, and tracks whether response behavior is improving or worsening.

Sender analysis skill. Ranks senders by volume, identifies concentration risk, detects high-noise senders, and separates important contacts from clutter sources.

Spam analysis skill. Measures spam volume, identifies spam trends, compares spam vs inbox ratio, and helps users understand how much of their incoming email is noise.

Quick inbox summary without full deep analysis. Provides a fast snapshot of email volume, unread count, top senders, and key metrics for a given period.

Trend analysis across time periods. Compares email activity across days, weeks, or months to surface seasonality, spikes, and long-term patterns.

Analyzes unread email patterns. Filters to show only unread messages, measures backlog depth, identifies neglected threads, and tracks whether the unread count is growing or shrinking over time.