search-calendar_skill

Overview

This skill lets you search Google Calendar using natural language to find events by date, title, attendees, or email domains. It is optimized for time-based briefings, returning explicit ISO timestamps in Asia/Singapore timezone and rich event context like attendees, duration, conferencing, and a prep_needed flag. Results are filtered, enriched, and sorted for quick timeline integration.

How this skill works

Parse the user's query to extract time references (day, date, week), subject keywords, attendee names, and email filters. Retrieve events from calendars in the identified time range, exclude cancelled events, and apply fuzzy matching for names and partial matches for emails and subjects. Enrich each event with duration in minutes, full attendee list with RSVP status, conference links, description, attachment presence, and a prep_needed indicator based on document links, keywords, attachments, or attendee count.

When to use it

• Get a timeline for today, tomorrow, a specific date, or a calendar week
• Find all meetings with a person or group (by name or email/domain)
• Search for events by subject or partial title (e.g., 'huddle', 'standup')
• Prepare daily briefings that need explicit SGT timestamps and prep flags
• Filter meetings that likely need preparation (documents, >5 attendees)

Best practices

• Be specific with at least one dimension: time, person, or subject to narrow results
• Use natural phrases like 'next Monday' or 'this week' for reliable parsing
• Provide email domains (e.g., sentient.io) to quickly find external meetings
• Prefer attendee names plus a date range to locate exact instances
• Ask a clarifying question when name matches are ambiguous

Example use cases

• Show events with Eddie next week, enriched with conference links and prep flags
• List all 'SnR:Huddle' meetings this week and include descriptions and durations
• Find meetings on 2025-10-21 and return start/end times in Asia/Singapore timezone
• Get events with @sentient.io attendees in the next 30 days for client prep
• Build a chronological briefing for today with prep_needed markers and links