Sauna Skills

                    ---
name: "Calendar Blocker"
description: "User wants to block time on their calendar and handle affected meetings.
Triggers: \"clear my calendar\", \"block Saturday\", \"I'm delayed until Thursday\",
\"I won't be available\", \"cancel my afternoon\", \"I need to reschedule everything\"
"
requiredApps: [google_calendar, gmail]
---

Block time on your calendar and let me handle the fallout. Tell me when you'll be unavailable - "clear Saturday", "I'm delayed until Thursday evening", "block tomorrow afternoon" - and I'll find every affected meeting, draft notifications to the right people, and update your calendar.

For each meeting in your blocked window, I'll suggest the right action: reschedule important 1:1s, decline optional standups, send professional apologies to external contacts. You review and approve each notification before it goes out. Then I'll add a blocking event so nothing else gets scheduled.


**Limitations:** Cannot check other people's calendars for rescheduling availability. Handles primary calendar only.


## Skills

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

**Calendar Reader**
When: Fetch events in the blocked time window
Follow the instructions in: `./skills/sauna/calendar.block.handler/references/skills/calendar.google.reader/SKILL.md`

**google_calendar**
When: Create blocking event and update/cancel meetings
Follow the instructions in: `./skills/sauna/calendar.block.handler/references/skills/calendar.google.events/SKILL.md`

**Gmail Draft Composer**
When: Draft notification emails to affected attendees
Follow the instructions in: `./skills/sauna/calendar.block.handler/references/skills/gmail.draft.composer/SKILL.md`

**Time Mastery**
When: Parse flexible time expressions like 'Thursday evening'
Follow the instructions in: `./skills/sauna/calendar.block.handler/references/skills/world.time.mastery/SKILL.md`


## Tasks

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

**Block Calendar Time**
When: User wants to block time and handle affected meetings
Follow the instructions in: `./skills/sauna/calendar.block.handler/references/recipes/calendar.block.handle.md`



## UI

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

**Connection Profiles**
When: Check user's timezone and contact context
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.



## Knowledge

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

**Calendar Blocking Guide**
When: Reference for notification tone and rescheduling strategies
Read the documentation in: `./skills/sauna/calendar.block.handler/references/calendar.block.guide.md`

                  

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

2. Ensure Google Calendar and Gmail are connected. Tell the user you can help them block time and handle affected meetings. Ask what time period they need to clear.