Sauna Skills

                    ---
name: "Gmail Discovery"
description: "User wants to connect Gmail, set up their inbox profile, or learn their email patterns.
Triggers: \"connect gmail\", \"set up gmail\", \"learn my email patterns\",
\"who do I email\", \"my email contacts\", \"gmail profile\"
"
requiredApps: [gmail]
---

Know your inbox before you use it. This skill connects Gmail and builds a comprehensive profile of how you communicate—your key contacts, email patterns, and writing style.

In about 3 minutes, it analyzes your sent messages and inbox to identify who you email most (and who's mutual), extracts personal context from confirmations and receipts, and captures your writing voice for future drafts. The profile powers personalization across all Gmail operations.

Run once to set up, then periodically refresh as your patterns evolve.


**Limitations:** Read-only analysis—cannot send, modify, or delete emails.


## Skills

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

**Writing Voice Capture**
When: Analyzing writing style from sent emails
Follow the instructions in: `./skills/sauna/gmail.inbox.discovery/references/skills/context.style.analyzer/SKILL.md`

**Entity Manager**
When: Resolving and merging contact entities
Follow the instructions in: `./skills/sauna/gmail.inbox.discovery/references/skills/context.entity.manager/SKILL.md`


## Tasks

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

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



## UI

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

**Connection Profiles**
When: Check existing Gmail profile
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 user context extracted from Gmail
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: Check captured writing style
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.

**People Directory**
When: Check extracted contacts
Use this directory: `./documents/entities/people/*.md`
Usage Guide: Unified profiles for people the user interacts with across services. Each person gets one file named by full-name slug (john-smith.md). Contains: name, relationship to user, contact methods (email, Slack handle, LinkedIn), interaction context (how they know them, recent interactions), and cross-references to service-specific data.
CREATE when a person appears meaningfully in 2+ services, or user explicitly saves someone. UPDATE when new interaction context emerges. MERGE entries if same person discovered across services (e.g., Gmail contact matches Slack DM). Don't duplicate raw data from services—link to service profiles.
Skills should CHECK here before creating service-specific contact entries. This is the canonical "who does the user know" index.



## Knowledge

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

**Gmail Wow Moments**
When: Presenting profile insights to user
Read the documentation in: `./skills/sauna/gmail.inbox.discovery/references/gmail.inbox.wow.md`

                  

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

2. Ensure Gmail is connected. Tell the user you'll analyze their inbox to understand their contacts, patterns, and writing style. Run ./skills/sauna/gmail.inbox.discovery/references/recipes/gmail.inbox.setup.md.