Sauna Skills

                    ---
name: "Notion Discovery"
description: "User wants to connect Notion, analyze their workspace, or understand how they use it.
Triggers: \"connect notion\", \"set up notion\", \"analyze my notion\",
\"notion workspace\", \"how do I use notion\", \"notion profile\"
"
requiredApps: [notion]
---

Understand how you use Notion before working with it. This skill connects your workspace and builds a comprehensive profile—your active databases, frequent pages, collaboration patterns, and writing style.

In about 3 minutes, it analyzes 90 days of activity to identify where you spend your time, what topics you write about, and how you typically structure content. The profile powers personalization across all Notion operations.

Run once to set up, then periodically refresh as your workspace evolves.


**Limitations:** Pages must be explicitly shared with the Notion integration to be accessed.


## Skills

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

**Writing Voice Capture**
When: Analyzing writing style from Notion content
Follow the instructions in: `skills/sauna/notion.workspace.discovery/references/skills/context.style.analyzer/SKILL.md`


## Tasks

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

**Build Notion Profile**
When: First use, user wants to connect Notion, or refresh their workspace profile
Follow the instructions in: `skills/sauna/notion.workspace.discovery/references/recipes/notion.workspace.setup.md`



## State

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

**Service Profiles**
When: Check existing Notion profile
Use this directory: `documents/user/services/*.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, aggregate statistics, 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 Facts**
When: Check user context extracted from Notion (files: personal, interests, goals)
Use this directory: `documents/user/profile/[file=personal|goals|interests|ideology].md`
Usage Guide: Core user knowledge organized by life domain. Each domain gets its own file: personal.md (location, family, birthday, routines, relationships), goals.md (career goals, milestones, learning targets), interests.md (hobbies, media, communities), ideology.md (political compass results, values assessments).
Work context (role, company, team) lives in state:work.context.overview, not here.
UPDATE when facts emerge from conversations or service integrations. Include source attribution (e.g., "From Gmail:", "From Slack:") for automatically discovered facts. Track progress on goals when mentioned. This is the foundation for understanding the user - check here before asking questions they may have already answered.
File naming: lowercase domain name (personal.md, goals.md, interests.md, ideology.md).

**User Analysis Results**
When: Check captured writing style (file: writing-style.md)
Use this directory: `documents/user/analysis/*.md`
Usage Guide: Personality and style analysis results. Each analysis type gets its own file: enneagram.md (type, wing, scores), compass.md (political position, ideology), writing-style.md (tone, formality, patterns by service), mbti.md, etc.
CREATE when user completes an assessment or analysis task. OVERWRITE on retake for assessments (enneagram, compass). UPDATE incrementally for observed patterns (writing style). Include source attribution for automatically discovered patterns.
File naming: lowercase analysis type with hyphens (e.g., writing-style.md).

                  

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

2. Ensure Notion is connected. Tell the user you'll analyze their workspace to understand their databases, pages, and writing style. Run skills/sauna/notion.workspace.discovery/references/recipes/notion.workspace.setup.md.