Sauna Skills

                    ---
name: Gmail
description: User asks about their email: finding messages, checking junk/spam levels, seeing who emails them most, getting a digest, archiving bulk messages, or drafting an email
---

Search emails with natural language or Gmail operators, fetch complete threads, compute inbox analytics, generate digests, bulk archive messages, and create drafts matching user's writing style.

**Limitations:** Cannot send emails directly—drafts must be sent manually from Gmail.


## Skills

This skill depends on the following skills. Use these if needed.

**Writing Style Analyzer**
When: User needs style-matched email drafts or asks about their writing patterns
Follow the instructions in: `./skills/sauna/gmail.inbox.hub/resources/skills/context.style.analyzer/SKILL.md`


## Tasks

These are tasks you can execute. Read the task file to get your instructions:

**Setup Gmail Connection**
When: First use, or user wants to refresh their profile
Follow the instructions in: `./skills/sauna/gmail.inbox.hub/resources/recipes/gmail.inbox.setup.md`

**Search Gmail**
When: User wants to find specific emails or search their inbox
Follow the instructions in: `./skills/sauna/gmail.inbox.hub/resources/recipes/gmail.inbox.search.md`

**Analyze Inbox**
When: User asks about patterns, stats, or who emails them most
Follow the instructions in: `./skills/sauna/gmail.inbox.hub/resources/recipes/gmail.inbox.analyze.md`

**Inbox Digest**
When: User wants a summary of recent activity
Follow the instructions in: `./skills/sauna/gmail.inbox.hub/resources/recipes/gmail.inbox.digest.md`

**Archive Gmail Messages**
When: User wants to archive or clean up emails
Follow the instructions in: `./skills/sauna/gmail.inbox.hub/resources/recipes/gmail.inbox.archive.md`

**Create Email Draft**
When: User wants to draft or compose an email
Follow the instructions in: `./skills/sauna/gmail.inbox.hub/resources/recipes/gmail.draft.create.md`



## UI

These are areas on the user's filesystem that you can read from and write to.

**Connection Profiles**
When: Check who user emails most and their Gmail patterns
Use this directory: `./documents/connections/[service-name].md`
Usage Guide: Service-specific context for each connected integration (gmail.md, slack.md, notion.md). Each file captures: key contacts/channels the user interacts with, usage patterns and preferences, important labels/tags/folders, and any service-specific conventions. Create when first profiling a service; update when user corrects or patterns shift significantly. Don't duplicate raw API data—summarize what matters for task execution. Reference these before drafting messages or organizing content to match user's established patterns for that service.

**User Profile**
When: Check before responding to personalize interactions
Use this directory: `./documents/user/[personal|work|goals|interests].md`
Usage Guide: Core user knowledge organized by life domain. Accumulate facts as they emerge from conversations and tasks. This is the foundation for understanding the user.

**Writing Style**
When: Reference when drafting emails to match user's voice
Use this file: `./documents/user/writing_style.md`
Usage Guide: Captured writing style patterns organized by service (Gmail, Notion, Slack) - tone, formality, structure, phrases, greetings, signatures. Each service has its own section to preserve context-specific styles. Used to draft content matching the user's voice.

**Inbox Analysis**
When: Reference past inbox analytics and insights
Use this file: `./documents/inbox/analysis.yaml`
Usage Guide: Aggregate inbox statistics updated after each digest run. Tracks: top senders by volume and response rate, peak email hours/days, average response times, label/folder distribution, and trend data (week-over-week changes). Structure as YAML with dated snapshots for historical comparison. Update incrementally—merge new data with existing stats rather than replacing. Used to prioritize inbox processing and identify communication patterns. Don't store individual email content—only aggregate metrics.

**Inbox Digests**
When: Reference previously generated digest summaries
Use this directory: `./documents/inbox/digests/*`
Usage Guide: Historical inbox summaries named by date (YYYY-MM-DD-daily.md, YYYY-WW-weekly.md). Each digest contains: priority threads requiring action, important updates grouped by sender/topic, and a quick-scan summary. Create new file per digest period—never overwrite past digests as they serve as searchable history. Keep last 30 daily and 12 weekly digests; archive older ones. Reference past digests to identify patterns or find "that email from last month." Don't duplicate full email content—summarize and link to thread IDs.



## Knowledge

This is knowledge you have access to. Read these files if you need additional context:

**Gmail Inbox Overview**
When: Read before any Gmail operation
Read the documentation in: `./skills/sauna/gmail.inbox.hub/resources/context/gmail.inbox.overview.md`

**Email Drafting Guidelines**
When: Drafting or composing an email
Read the documentation in: `./skills/sauna/gmail.inbox.hub/resources/context/gmail.draft.rules.md`

                  

                    1. Install Gmail with: ```bash
rm -rf ./skills/sauna/gmail.inbox.hub && curl -fsSL "https://sk.ills.app/api/skill/gmail.inbox.hub/download" | tar -xzf - -C ./skills/sauna/ && cat ./skills/sauna/gmail.inbox.hub/SKILL.md
```. Do so silently without commentary.

2. If Gmail isn't connected, help connect. Then run `./skills/sauna/gmail.inbox.hub/resources/recipes/gmail.inbox.setup.md`.