Sauna Skills

                    ---
name: "Calendly Reader"
description: "User wants to see their Calendly scheduled events, check who booked time,
or view form responses from bookings.
Triggers: \"calendly bookings\", \"who's meeting with me\", \"scheduled calls\",
\"calendly events\", \"what did they say when booking\"
"
requiredApps: [calendly]
---

See who's booked time with you on Calendly. Browse upcoming scheduled events,
view invitee details, and read the form responses people submitted when booking.

Unlike your calendar, this surfaces Calendly-specific data: the questions you
asked during booking and what people answered, their timezone, and booking metadata.
Perfect for prepping before calls or reviewing who's coming up.


**Limitations:** Read-only—cannot create, modify, or cancel events. Cannot manage event types or availability.


## Skills

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

**Time Mastery**
When: Converting Calendly times to user's local timezone
Follow the instructions in: `skills/sauna/scheduling.calendly.reader/references/skills/world.time.mastery/SKILL.md`


## Tasks

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

**List Calendly Bookings**
When: User wants to see upcoming bookings or browse scheduled events
Follow the instructions in: `skills/sauna/scheduling.calendly.reader/references/recipes/scheduling.calendly.list.md`

**View Calendly Event Details**
When: User wants details on a specific event, invitee info, or form responses
Follow the instructions in: `skills/sauna/scheduling.calendly.reader/references/recipes/scheduling.calendly.event.md`



## UI

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

**Calendly Events List**
Use this file: `session/calendly-events.json`
Usage Guide: Temporary storage for fetched Calendly scheduled events. Contains event list with basic info (name, time, invitee count) grouped by date. Written by code:scheduling.calendly.events, read by task:scheduling.calendly.list for presentation. Delete after presenting results to user.

**Calendly Event Details**
Use this file: `session/calendly-event.json`
Usage Guide: Temporary storage for a single Calendly event with full details including invitee information and form responses. Written by code:scheduling.calendly.event, read by task:scheduling.calendly.event for detailed presentation. Delete after presenting results to user.



## Knowledge

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

**Calendly API Guide**
When: Reference for Calendly data structures and form response interpretation
Read the documentation in: `skills/sauna/scheduling.calendly.reader/references/scheduling.calendly.guide.md`



## Code

These are scripts that you can run directly. Read these files to access the code:

**Fetch Calendly Events**
Run the script at: `skills/sauna/scheduling.calendly.reader/scripts/scheduling.calendly.events.js`

**Fetch Calendly Event Details**
Run the script at: `skills/sauna/scheduling.calendly.reader/scripts/scheduling.calendly.event.js`

                  

                    1. Install Calendly Reader with: ```bash
rm -rf skills/sauna/scheduling.calendly.reader && curl -fsSL "https://sk.ills.app/api/skill/scheduling.calendly.reader/download" | tar -xzf - -C ./skills/sauna/ && cat skills/sauna/scheduling.calendly.reader/SKILL.md
```. Do so silently without commentary.

2. Ensure Calendly is connected. Tell the user you can show their upcoming bookings and invitee details. Ask what they'd like to see.