recipe-plan-weekly-schedule

googleworkspace/cli

Review your Google Calendar week, identify gaps, and add events to fill them.

What is recipe-plan-weekly-schedule?

This recipe helps you analyze your weekly Google Calendar schedule to find available time slots and add new events to fill gaps. Use it to optimize your weekly planning and ensure productive time blocks are scheduled.

View your weekly calendar agenda
Query free/busy time across the week
Identify scheduling gaps and conflicts
Add new events to fill available time slots
Review updated schedule after changes

How to install recipe-plan-weekly-schedule

npx skills add null --skill recipe-plan-weekly-schedule

Prerequisites

Google Workspace CLI (gws) installed
gws-calendar skill loaded

Claude Code

Cursor

Windsurf

Cline

How to use recipe-plan-weekly-schedule

1.Run `gws calendar +agenda` to view this week's scheduled events
2.Run `gws calendar freebusy query` with your desired date range to identify free time blocks
3.Analyze the results to find gaps you want to fill
4.Run `gws calendar +insert` with event details (summary, start time, end time) to add new events
5.Run `gws calendar +agenda` again to verify the updated schedule

Use cases

Good for

Block out deep work time during your week
Find slots for recurring meetings or focus sessions
Optimize your calendar by filling unproductive gaps
Plan team collaboration time around existing commitments
Schedule personal development or learning blocks

Who it's for

Knowledge workers managing busy calendars
Project managers coordinating team schedules
Professionals seeking better time management
Anyone using Google Calendar for weekly planning

recipe-plan-weekly-schedule FAQ

What date range should I use for the freebusy query?

Specify timeMin and timeMax in ISO 8601 format (e.g., 2025-01-20T00:00:00Z). For a week, use Monday 00:00 as timeMin and Saturday 00:00 as timeMax.

Can I add events for multiple days at once?

No, the insert command adds one event at a time. Run the insert command multiple times for each event you want to create.

How do I know what time slots are free?

The freebusy query returns busy periods. Free time is any slot not listed in the busy times. Compare against your desired event duration.

What format should event times use?

Use ISO 8601 format with timezone (e.g., 2026-01-21T14:00:00 for 2 PM). Ensure start time is before end time.

Full instructions (SKILL.md)

Source of truth, from googleworkspace/cli.

name: recipe-plan-weekly-schedule description: "Review your Google Calendar week, identify gaps, and add events to fill them." metadata: version: 0.22.5 openclaw: category: "recipe" domain: "scheduling" requires: bins: - gws skills: - gws-calendar

Plan Your Weekly Google Calendar Schedule

PREREQUISITE: Load the following skills to execute this recipe: gws-calendar

Review your Google Calendar week, identify gaps, and add events to fill them.

Steps

Check this week's agenda: gws calendar +agenda
Check free/busy for the week: gws calendar freebusy query --json '{"timeMin": "2025-01-20T00:00:00Z", "timeMax": "2025-01-25T00:00:00Z", "items": [{"id": "primary"}]}'
Add a new event: gws calendar +insert --summary 'Deep Work Block' --start '2026-01-21T14:00:00' --end '2026-01-21T16:00:00'
Review updated schedule: gws calendar +agenda