Sauna Skills

                    ---
name: "Slack Block Kit"
description: "User wants to create a rich Slack message, announcement, or formatted update.
Triggers: \"slack announcement\", \"format for slack\", \"block kit\",
\"rich slack message\", \"make it look good for slack\", \"slack update\"
"
requiredApps: [slack]
---

Turn plain text into polished Slack announcements. Block Kit is Slack's rich formatting system—headers, sections, metrics grids, buttons, dividers—and this skill helps you compose messages that actually look professional.

Describe what you want to announce or update, and I'll structure it with proper Block Kit JSON: headers for titles, sections with bullet points, fields for metrics, context for metadata. Perfect for weekly updates, release announcements, or any message that deserves more than plain text.

Preview the formatted message before sending, then click to post directly to your channel.


**Limitations:** Block Kit has limits: 50 blocks max, 10 fields per section, no nested blocks.


## Skills

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

**Slack Sender**
When: Sending the composed Block Kit message
Follow the instructions in: `./skills/sauna/slack.blockkit.composer/references/skills/slack.message.sender/SKILL.md`


## Tasks

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

**Compose Block Kit Message**
When: User wants to create and send a rich formatted message
Follow the instructions in: `./skills/sauna/slack.blockkit.composer/references/recipes/slack.blockkit.compose.md`



## UI

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

**Slack Block Kit JSON**
When: Write composed Block Kit JSON for sending
Use this file: `./documents/tmp/slack-blocks.json`
Usage Guide: Temporary storage for Block Kit JSON payload when sending rich-formatted Slack messages. Written before sending, cleaned up after success.

**Writing Style**
When: Match user's communication style and formatting preferences
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.

**Stated Preferences**
When: Check explicit messaging preferences
Use this file: `./documents/preferences/stated.yaml`
Usage Guide: Explicit preferences the user has stated. Structured YAML with categories: communication (response length, formality defaults), scheduling (preferred meeting times, buffer preferences), content (formatting preferences, tone for different contexts), and tool-specific preferences.
WRITE when user explicitly states a preference ("I prefer...", "Always...", "Never..."). UPDATE when user changes a stated preference. Each entry includes: preference, context, and when it was stated.
Higher confidence than learned preferences—user explicitly said this.



## Knowledge

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

**Slack Message Formatting**
When: Reference Block Kit structure and templates
Read the documentation in: `./skills/sauna/slack.blockkit.composer/references/compose.format.slack.md`

**Slack Guide**
When: Need Slack API details (Block Kit, channels, threads)
Read the documentation in: `./skills/sauna/slack.blockkit.composer/references/chat.slack.guide.md`

                  

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

2. Ensure Slack is connected. Tell the user you can create rich, beautifully formatted Slack messages with Block Kit. Ask what they want to announce and which channel.