Menu
Resolves time period arguments (today, week, month, year, custom date range) into concrete start and end dates for Gmail data queries.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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.
| name | gmail-period |
| description | Resolves time period arguments (today, week, month, year, custom date range) into concrete start and end dates for Gmail data queries. |
Convert period keywords and date flags into concrete date ranges that other skills and scripts can use for data fetching and filtering.
| Input | Resolved Range |
|---|---|
today | Start of today → now |
week | 7 days ago → now |
month | 30 days ago → now (or calendar month) |
year | 365 days ago → now (or calendar year) |
--from YYYY-MM-DD --to YYYY-MM-DD | Exact custom range |
All skills that accept a <period> argument delegate to this skill for
date resolution before fetching or filtering data.
