name	office:calendar-management
description	Manage calendar events, check conflicts, handle scheduling from emails. Use when adding events or coordinating meetings to ensure proper timezone handling and conflict detection.

Calendar Management with Office Admin

When to Use This Skill

Use this skill when:

Adding events from emails
Checking for scheduling conflicts
Creating calendar holds for tentative events
Converting timezones for international contacts
Managing working hours and availability
Blocking focus time or recurring events

User Calendar Preferences

Load preferences from ~/.claude/office-admin-config.json:

{
  "personal": {
    "timezone": "America/Chicago",
    "workingHours": {
      "start": "09:30",
      "end": "16:30",
      "lunchStart": "12:00",
      "lunchEnd": "13:30"
    }
  },
  "calendar": {
    "defaultDuration": 30,
    "bufferMinutes": 15,
    "schedulingLink": "https://user.cal.com/schedule",
    "autoAddFromEmail": true,
    "eventNaming": {
      "includeLocation": true,
      "includeAttendees": false
    }
  }
}

Core Principles

Always check conflicts first - Before committing to an event
Respect working hours - Use user's configured schedule
Handle timezones carefully - Convert accurately, show both zones
Be proactive - Auto-add events from emails when configured
Use descriptive titles - Include location/context per user preference

Adding Events from Emails

Step 1: Extract Event Details

Look for in the email:

Date and time (or phrases like "tomorrow", "next Tuesday", "in two weeks")
Duration (or use defaultDuration from config)
Location (physical address, restaurant name, virtual link)
Event type (meeting, lunch, coffee, party, etc.)
Attendees (who else is invited)
Special notes (dress code, what to bring, etc.)

Step 2: Parse Relative Dates

Handle conversational dates:

"tomorrow" → current date + 1 day
"next Monday" → next occurrence of Monday
"in two weeks" → current date + 14 days
"Dec 5" → December 5 of current year (or next if passed)

Step 3: Check Calendar for Conflicts

BEFORE creating the event:

# Get user's calendar for that date
mcp__pd__google_calendar-list-events(
  instruction="Get all events for [date], between [start_time - bufferMinutes] and [end_time + bufferMinutes]"
)

Look for:

Direct conflicts (overlapping times)
Buffer violations (< bufferMinutes between events)
Lunch conflicts (check workingHours.lunch* from config)
End-of-day violations (past workingHours.end)

Step 4: Report Availability

Tell the user:

If free:

You're free at [time] on [date].

If conflict exists:

That conflicts with:
- [event name] from [start] to [end]

Your schedule that day:
9:30am - 10:30am: Team standup
10:30am - 12:00pm: FREE
12:00pm - 1:30pm: Lunch
1:30pm - 3:00pm: [Proposed event would go here]
3:00pm - 4:00pm: Client call

Step 5: Create the Event

If user confirms or no conflict exists:

mcp__pd__google_calendar-create-event(
  instruction="Create event with:
  - Title: [descriptive title with location if includeLocation=true]
  - Date: [YYYY-MM-DD]
  - Start time: [HH:MM] [timezone]
  - End time: [HH:MM] [timezone]
  - Location: [physical address or link]
  - Description: [context about who invited, what it's about]
  - Attendees: [email addresses]
  "
)

Title format examples:

If includeLocation: true: "Lunch with Mike at Soho House"
If includeLocation: false: "Lunch with Mike"
If includeAttendees: true: "Meeting with Mike, Sarah, John"

Timezone: Always use user's timezone from config unless explicitly scheduling with someone in another timezone.

Step 6: Confirm Addition

Provide:

Event summary
Calendar link for verification
Note any adjustments made (e.g., moved 15min earlier to respect buffer)

Handling Tentative Events

For events pending confirmation:

Create with "HOLD:" prefix

Title: "HOLD: Call with Jean (pending confirmation)"

Add note in description

Description: "(pending confirmation) Call with Jean Labuschagne about consulting opportunity"

Update when confirmed
- Remove "HOLD:" prefix
- Update description to remove "pending" note
Delete if falls through
- Remove the calendar event
- Log in CRM why it didn't happen (if tracking deals)

Timezone Handling

For Same-Timezone Contacts

Use user's timezone from config:

Time: 2:00 PM America/Chicago

For Different-Timezone Contacts

When scheduling with someone in another timezone:

Specify both timezones in email:

"How about 9am Chicago time (4pm Zurich)?"

Double-check conversion:
- Look up their timezone
- Calculate offset from user's timezone
- Verify conversion is correct
- Account for DST differences
Common international contacts: Keep a mental note of frequent timezone conversions:
- US East Coast: +1 hour from Chicago (America/New_York)
- UK: +6 hours from Chicago (Europe/London)
- Central Europe: +7 hours from Chicago (Europe/Zurich)
- Tokyo: +15 hours from Chicago (Asia/Tokyo)

Create event in user's timezone:

Title: "Call with Jean in Zurich"
Time: 9:00 AM America/Chicago
Description: "9am Chicago / 4pm Zurich - Call with Jean Labuschagne"

Working Hours Awareness

Checking Availability

When someone asks "when are you free?":

Check user's workingHours from config
Look for gaps between existing events
Respect bufferMinutes between meetings
Avoid scheduling during lunch hours
Prefer morning or afternoon blocks

Typical Day Structure

Based on config defaults:

9:30am - Start of working day
    ↓
[Morning block for meetings/work]
    ↓
12:00pm - 1:30pm - Lunch (avoid scheduling)
    ↓
[Afternoon block for meetings/work]
    ↓
4:30pm - End of working day

Buffer Management

Apply bufferMinutes (default: 15) between events:

10:00am - 11:00am: Meeting A
[15 min buffer]
11:15am - 12:00pm: Meeting B

Don't schedule back-to-back unless user explicitly requests.

Recurring Events

For recurring events (weekly standups, monthly check-ins):

mcp__pd__google_calendar-create-event(
  instruction="Create recurring event:
  - Title: [name]
  - Frequency: [daily/weekly/monthly]
  - Day: [Monday, Tuesday, etc. for weekly]
  - Time: [HH:MM]
  - Duration: [minutes]
  - Until: [end date or 'indefinitely']
  "
)

Focus Time / Blocking

For work blocks or focus time:

mcp__pd__google_calendar-create-event(
  instruction="Create focus time block:
  - Title: 'Focus Time' or 'Deep Work'
  - Mark as: Busy
  - Visibility: Private (optional)
  - Duration: [typically 2-4 hours]
  - Recurring: [if regular pattern]
  "
)

Integration with Email Skill

When email-management skill sees scheduling language:

Extract event details
Call this skill to check conflicts
Report back to email skill
Email skill includes availability in draft response
This skill creates event once confirmed

Seamless handoff between skills.

Common Scenarios

Scenario 1: Lunch Invitation

Email: "Want to grab lunch next Tuesday?"

1. Check calendar for next Tuesday
2. Check lunch hours (12:00-1:30pm from config)
3. Look for conflicts in that window
4. Report: "You're free for lunch on Tuesday Dec 5"
5. Create tentative hold
6. Once confirmed, create proper event with restaurant location

Scenario 2: Meeting Request with Multiple Options

Email: "Can we meet Monday or Tuesday afternoon?"

1. Check both Monday and Tuesday afternoons
2. Identify all free slots after lunch
3. Report: "You're free:
   - Monday 2:00pm-4:30pm
   - Tuesday 1:30pm-3:00pm, 4:00pm-4:30pm"
4. Let user choose
5. Create event for chosen slot

Scenario 3: International Call

Email from Switzerland: "9am your time?"

1. Confirm user's timezone (America/Chicago)
2. Calculate Switzerland time (4pm CET)
3. Check 9am Chicago for conflicts
4. Report availability
5. Create event with both timezones in description

Common Mistakes to Avoid

❌ Not Checking Conflicts

Problem: Double-booking user Solution: ALWAYS check calendar before confirming availability

❌ Wrong Timezone

Problem: Event created in wrong timezone, user misses meeting Solution: Use timezone from config, verify conversions carefully

❌ Ignoring Buffers

Problem: Back-to-back meetings with no break Solution: Apply bufferMinutes between events

❌ Scheduling During Lunch

Problem: Booking meetings during lunch hours Solution: Check workingHours.lunchStart/End from config

❌ Vague Event Titles

Problem: "Meeting" with no context Solution: Include who, what, where based on eventNaming preferences

❌ Forgetting to Create Holds

Problem: User verbally commits but event not tracked Solution: Always create HOLD events for tentative commitments

Integration Checklist

Before completing a calendar task:

Loaded user's calendar preferences from config
Checked for conflicts with sufficient buffer
Verified timezone is correct
Respected working hours and lunch time
Used descriptive event title per preferences
Added location if includeLocation enabled
Included relevant attendees
Added context in description
Confirmed event was created successfully
Provided calendar link to user

Success Criteria

You're managing calendar well when:

No double-bookings occur
User has appropriate buffers between meetings
Timezone conversions are accurate
Event titles are clear and helpful
Working hours are respected
Conflicts are caught before committing
Integration with email is seamless

Remember

Calendar management is about protecting user's time and making scheduling effortless. Be proactive, be accurate, and always check conflicts first.

office:calendar-management

Install Skill

SKILL.md