Recipe Plan Weekly Schedule
Audit your Google Calendar week with the gws CLI, spot open blocks, and insert deep-work or focus events without leaving the agent.
Overview
recipe-plan-weekly-schedule is an agent skill for the Operate phase that reviews your Google Calendar week via gws, finds gaps with free/busy, and inserts events to fill them.
Install
npx skills add https://github.com/googleworkspace/cli --skill recipe-plan-weekly-scheduleWhat is this skill?
- Four-step recipe: `gws calendar +agenda`, free/busy JSON query, `+insert` event, second agenda pass
- Hard prerequisite: load `gws-calendar` and have `gws` binary on PATH (metadata v0.22.5)
- Parameterized inserts with `--summary`, `--start`, and `--end` for focus blocks like deep work
- OpenClaw recipe metadata: domain scheduling, category recipe
- Designed as a composable follow-on after mastering base calendar read/write skills
- 4-step recipe
- prerequisite skill gws-calendar
- metadata version 0.22.5
Adoption & trust: 15.9k installs on skills.sh; 26.9k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You know your week is fragmented but manually cross-checking Calendar free time and adding focus blocks is tedious inside chat.
Who is it for?
Solo builders already using the gws CLI and gws-calendar who want a scripted weekly time-blocking ritual in the agent.
Skip if: Teams without Google Calendar, anyone who has not installed gws or loaded gws-calendar, or builders who need multi-calendar resource planning beyond this single-week recipe.
When should I use this skill?
Review your Google Calendar week, identify gaps, and add events to fill them.
What do I get? / Deliverables
After the recipe runs, your primary calendar shows newly inserted blocks and an updated agenda view you can refine in follow-up inserts.
- Updated week agenda via gws calendar +agenda
- One or more inserted calendar events with defined start/end
Recommended Skills
Journey fit
Weekly calendar reshaping is ongoing personal operations—how you protect build time after launch, not a one-time validate or ship gate. Iterate fits recurring schedule tuning: review agenda, query free/busy, add blocks, re-check agenda in a tight feedback loop.
How it compares
Use as a fixed command checklist instead of asking the agent to guess Calendar API steps ad hoc.
Common Questions / FAQ
Who is recipe-plan-weekly-schedule for?
Indie developers and founders who manage their own Google Calendar through the gws toolchain and want agent-guided gap filling for focus time.
When should I use recipe-plan-weekly-schedule?
Use it during Operate iterate when you reset weekly rhythms, after a sprint ship crunch, or whenever you need to reclaim open slots before committing to new build work.
Is recipe-plan-weekly-schedule safe to install?
It instructs calendar reads and writes via your local gws auth; review the Security Audits panel on this Prism page and scope OAuth tokens before granting write access.
Workflow Chain
Requires first: gws calendar
SKILL.md
READMESKILL.md - Recipe Plan Weekly Schedule
# 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 1. Check this week's agenda: `gws calendar +agenda` 2. 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"}]}'` 3. Add a new event: `gws calendar +insert --summary 'Deep Work Block' --start '2026-01-21T14:00:00' --end '2026-01-21T16:00:00'` 4. Review updated schedule: `gws calendar +agenda`