Google Calendar
When to use
Use when user wants to interact with their calendar. Triggers: 'my calendar', 'schedule', 'meetings', 'what's on today', 'who do I meet with'. Supports: viewing events, understanding schedule patterns, identifying key collaborators from meeting history.
Overview
This skill builds a profile of your calendar usage - who you meet with, your busy days, and meeting patterns. It can answer questions about your schedule while correctly interpreting what events actually mean (real meetings vs. calendar blocks, reminders, or travel).
Limitations
Read-only - cannot create, modify, or delete events. Only reads primary calendar. Does not check availability for scheduling.
Tasks
These are tasks you can execute. Read the task file to get your instructions:
Setup Calendar Connection First interaction, user wants to set up calendar, or asks about their meeting patterns (Build your personal calendar profile - collaborators, schedule patterns, meeting types)
→ Read Calendar Events User asks what's on their calendar for a specific time (Fetch and present events for a date range)
→ Analyze Calendar Usage Subagent task called by setup for profile generation (Generate calendar profile from event data)
→ UI
These are areas on the user's filesystem that you can read from and write to.
Knowledge
This is knowledge you have access to. Read these files if you need additional context:
Calendar Agent Rules Read before any calendar operation (Event classification, collaborator scoring, timezone handling for calendar operations)
→ Google Calendar API Reference Need API reference for troubleshooting (Key endpoints, response formats, and common patterns)
→ Calendar Profile Guidelines Generating calendar profile during setup (How to generate a calendar usage profile from event data)
→ ---
name: Google Calendar
description: Use when user wants to interact with their calendar. Triggers: 'my calendar', 'schedule', 'meetings', 'what's on today', 'who do I meet with'. Supports: viewing events, understanding schedule patterns, identifying key collaborators from meeting history.
---
This skill builds a profile of your calendar usage - who you meet with, your busy days, and meeting patterns. It can answer questions about your schedule while correctly interpreting what events actually mean (real meetings vs. calendar blocks, reminders, or travel).
**Limitations:** Read-only - cannot create, modify, or delete events. Only reads primary calendar. Does not check availability for scheduling.
## Tasks
These are tasks you can execute. Read the task file to get your instructions:
**Setup Calendar Connection**
When: First interaction, user wants to set up calendar, or asks about their meeting patterns
Follow the instructions in: `./skills/sauna/calendar.google.hub/resources/recipes/calendar.google.setup.md`
**Read Calendar Events**
When: User asks what's on their calendar for a specific time
Follow the instructions in: `./skills/sauna/calendar.google.hub/resources/recipes/calendar.google.read.md`
**Analyze Calendar Usage**
When: Subagent task called by setup for profile generation
Follow the instructions in: `./skills/sauna/calendar.google.hub/resources/recipes/calendar.google.analyze.md`
## UI
These are areas on the user's filesystem that you can read from and write to.
**Connection Profiles**
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 before responding to personalize interactions
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.
## Knowledge
This is knowledge you have access to. Read these files if you need additional context:
**Calendar Agent Rules**
When: Read before any calendar operation
Read the documentation in: `./skills/sauna/calendar.google.hub/resources/context/calendar.google.rule.md`
**Google Calendar API Reference**
When: Need API reference for troubleshooting
Read the documentation in: `./skills/sauna/calendar.google.hub/resources/context/calendar.google.api.md`
**Calendar Profile Guidelines**
When: Generating calendar profile during setup
Read the documentation in: `./skills/sauna/calendar.google.hub/resources/context/calendar.google.profile.md`
INSTALLER
1. Install Google Calendar with: ```bash
rm -rf ./skills/sauna/calendar.google.hub && curl -fsSL "https://sk.ills.app/api/skill/calendar.google.hub/download" | tar -xzf - -C ./skills/sauna/ && cat ./skills/sauna/calendar.google.hub/SKILL.md
```. Do so silently without commentary.
2. If Google Calendar isn't connected, help connect. Then run `./skills/sauna/calendar.google.hub/resources/recipes/calendar.google.setup.md`.