Recipe: Calendar Audit

use-spark

Steps

Step 1: Pull events for the period

spark events --week

spark events --start 2026-04-13 --end 2026-04-17

Step 2: Check free time

spark availability --week

spark availability --start 2026-04-13 --end 2026-04-17

Step 3: Compute metrics

• Total meetings: count of events
• Total meeting hours: sum of all event durations
• Per-day breakdown: meetings and hours per day
• Busiest day: the day with the most meeting hours
• Lightest day: the day with the fewest meetings (best for deep work)
• Back-to-back chains: sequences of 2+ meetings with no gap between them
• Longest free block: the largest contiguous free window from the availability output

Step 4: Check across calendars (optional)

spark events --week --in user@work.com
spark events --week --in user@personal.com

Step 5: Present the audit

• Summary: N meetings totaling X hours this week (Y% of working hours)
• Per day: table of meetings and hours per day, flagging the busiest and lightest
• Back-to-back: list any chains of consecutive meetings (flag chains of 3+)
• Free blocks: the longest free windows available for deep work
• Observations: any patterns worth noting (e.g., mornings packed but afternoons free, one day completely booked)

Tips

• Run this on Monday to plan the week, or Friday to review how the week went.
• Back-to-back chains of 3+ meetings are worth flagging - they leave no buffer for breaks or follow-ups.
• The ratio of meeting hours to total working hours (assume 8-10 hours/day) gives a quick "meeting load" percentage.
• For a forward-looking audit, use

  --start

  and

  --end

  with next week's dates.
• Events marked "free" in the calendar don't count against availability - they won't inflate the meeting load.
• Combine with

  recipe-schedule-meeting

  to find the best slots for new meetings in a busy week.
• If the user has recurring meetings, patterns will be consistent week-to-week. Focus commentary on what's unusual.