> ## Documentation Index
> Fetch the complete documentation index at: https://meganharrisonconsulting.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# google-calendar-group-scheduler

> Find and rank good meeting times for multiple people using connected Google Calendar data. Use when the user wants to schedule a group meeting, compare candidate slots across several attendees, find the best compromise time, or add a room check after narrowing the attendee-compatible options.

This page is generated from the actual `SKILL.md` file on disk.

## Metadata

| Field               | Value                                                                                                                                                                                                                                                                                                 |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Source group        | Plugin Skills                                                                                                                                                                                                                                                                                         |
| Source root         | `/Users/meganharrison/.codex/plugins/cache`                                                                                                                                                                                                                                                           |
| Relative skill path | `openai-curated/google-calendar/d08f0354/skills/google-calendar-group-scheduler/SKILL.md`                                                                                                                                                                                                             |
| Actual file         | `/Users/meganharrison/.codex/plugins/cache/openai-curated/google-calendar/d08f0354/skills/google-calendar-group-scheduler/SKILL.md`                                                                                                                                                                   |
| Description         | Find and rank good meeting times for multiple people using connected Google Calendar data. Use when the user wants to schedule a group meeting, compare candidate slots across several attendees, find the best compromise time, or add a room check after narrowing the attendee-compatible options. |
| Docs overview       | [Plugin Skills](/skills/plugin-skills)                                                                                                                                                                                                                                                                |

## Why this exists

Use this page when you want to review the real instructions behind a skill
without leaving the docs site. The content below is copied from the actual
`SKILL.md` file, not rewritten by hand.

## Raw SKILL.md

```md theme={null}
---
name: google-calendar-group-scheduler
description: Find and rank good meeting times for multiple people using connected Google Calendar data. Use when the user wants to schedule a group meeting, compare candidate slots across several attendees, find the best compromise time, or add a room check after narrowing the attendee-compatible options.
---

# Google Calendar Group Scheduler

Use this skill when the scheduling problem is the task.

## Relevant Actions

- Use `get_availability` for attendee and room/resource busy windows once you know the concrete calendar IDs.
- Use `search_events` when you need event context, candidate-room history, or a clearer read on what is creating conflicts.
- Use `read_event` or `search_events_all_fields` when the attendee emails, manager contact, room email, or full source-event details need to be recovered from existing calendar events.

## Workflow

1. Ground the scheduling problem first: date window, duration, timezone, required attendees, optional attendees, and any hard constraints such as "this week", "afternoons only", or "avoid lunch".
2. Normalize the request into explicit candidate windows before ranking anything.
3. If attendee or room identities are referenced indirectly, such as "my manager", "same attendees", or "the room we usually use", search a bounded relevant window and read the likely source event before asking the user for contact details.
4. Rank slots, do not enumerate everything. Optimize for a short list of strong options.
5. Prefer slots that minimize conflict cost, are reasonably fair across timezones, and avoid fragmenting the day for the most constrained attendees.
6. If no perfect slot exists, return the best compromise and state exactly who is impacted.
7. If the meeting also needs a room, first narrow to attendee-compatible slots, then check likely rooms or resources against those shortlisted times.

## Ranking Heuristics

- Favor required-attendee fit over optional-attendee fit.
- Favor slots that avoid very early or very late local times for distributed attendees.
- Favor slots that preserve lunch and avoid consuming the only large free block in someone's day unless the meeting is clearly important.
- Favor a small number of high-confidence options over a long weak list.
- When two slots are similar, prefer the one that causes less calendar fragmentation.

## Output Conventions

- Return 2-4 candidate slots by default.
- For each slot, say why it works and who, if anyone, would be inconvenienced.
- If there is no clean option, say what tradeoff the best slot is making.

```