Sauna Skills

                    ---
name: "Slack Discovery"
description: "User wants to connect Slack, set up their workspace profile, or learn their communication patterns.
Triggers: \"connect slack\", \"set up slack\", \"learn my slack patterns\",
\"who do I collaborate with\", \"my slack profile\", \"slack workspace\"
"
requiredApps: [slack]
---

Understand how you use Slack before you use it with AI. This skill connects your workspace and builds a comprehensive profile of your communication patterns—top channels, key collaborators, and your writing voice.

In about 3 minutes, it analyzes 90 days of your Slack activity to identify who you work with most closely (looking for bidirectional interaction, not just mentions), which channels are your home base, and how you typically communicate. The profile powers personalization across all Slack operations.

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


**Limitations:** Slack API does not allow reading DM content—only public/private channel messages are analyzed.


## Skills

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

**Writing Voice Capture**
When: Analyzing communication style from Slack messages
Follow the instructions in: `./skills/sauna/slack.workspace.discovery/references/skills/context.style.analyzer/SKILL.md`

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


## Tasks

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

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



## UI

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

**Connection Profiles**
When: Check existing Slack 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 Slack
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 communication 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 collaborators
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:

**Slack Wow Moments**
When: Presenting profile insights to user
Read the documentation in: `./skills/sauna/slack.workspace.discovery/references/slack.workspace.wow.md`

                  

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

2. Ensure Slack is connected. Tell the user you'll analyze their workspace to understand their channels, collaborators, and communication style. Run ./skills/sauna/slack.workspace.discovery/references/recipes/slack.workspace.setup.md.