Guide · Agent skill
How to use the Plan Your Weekly Calendar agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
This guide explains what the Plan Your Weekly Google Calendar Schedule skill does, how to install it, and how to ask an agent to review your week and add events into open time. It is aimed at people who have never used agent skills before. By the end you will know the prerequisites, how to trigger the skill with a plain request, and the safety points to check before letting it write to your calendar.
Plan Your Weekly Calendargoogleworkspace/cli · Apache-2.0 Download the skill Quick start
- 1Install the prerequisites. Install the gws command-line tool and make sure the gws-calendar skill is available. Authorise gws for your Google account with Calendar access.
- 2Download and unzip the skill. Download the ZIP from this page and unzip it so that SKILL.md is in a skills folder.
- 3Place the skill folder. Move the folder into ~/.claude/skills/ for a personal install, or into .claude/skills/ in your project. Alternatively, upload it under Settings → Capabilities → Skills in the Claude apps.
- 4Ask for a schedule review. Describe your goal in plain language, such as finding two hours of deep work this week.
- 5Check the free and busy times. Let the agent check your agenda and free or busy time for the week before it adds anything.
- 6Confirm the new event. Review the updated agenda the agent shows you and check the event appears where you expected.
What does the skill make the agent do?
The skill is a guided routine for scheduling in Google Calendar. It reviews your calendar week, identifies gaps, and adds events to fill them. The source steps are: check this week's agenda, check free or busy time for the week, add a new event such as a Deep Work Block, and then review the updated schedule.
It works by running the gws command-line tool to read and write your calendar. It is not a general calendar assistant, and it only works with Google Calendar.
- Reads your agenda for the week
- Checks when you are free or busy
- Adds new events, for example a focus block, into open time
- Shows you the updated schedule afterwards
What you need before installing
You need three things. The skill depends on the gws command-line tool (Google Workspace CLI), on the gws-calendar skill, which is listed as a prerequisite, and on a Google account that is authorised for Calendar access through gws.
If you do not use Google Calendar, this skill will not help, because it cannot read other calendar services.
- gws command-line tool (Google Workspace CLI)
- gws-calendar skill (listed as a prerequisite)
- A Google account authorised for Calendar access through gws
Install the skill
Download the ZIP file for the skill from this page and unzip it. The package contains a single file, SKILL.md. Put the unzipped folder in one of these locations, depending on how you want to use it.
For a personal install across all projects, place it in ~/.claude/skills/. For a single project, place it in that project's .claude/skills/ folder.
If you use the Claude apps instead, you can upload the skill under Settings → Capabilities → Skills.
- Personal install: ~/.claude/skills/
- Project install: .claude/skills/ inside your project
- Claude apps: Settings → Capabilities → Skills, then upload
Trigger the skill with a natural request
You do not need to type a command. Describe what you want in plain language and mention your calendar and week. The agent should pick up the skill from the description, which says it reviews your Google Calendar week, identifies gaps, and adds events to fill them.
Be specific about the outcome you want, such as time for deep work or errands, and the days or times that matter to you.
- "Look at my Google Calendar for this week and find gaps for two hours of deep work."
- "Check when I am free this week and block off an afternoon for errands."
- "Review my calendar week and add a focus block into any open time on Tuesday."
What the underlying commands look like
The skill runs gws commands behind the scenes. These are the examples from its steps. The first reads this week's agenda, the second checks free or busy time over a date range, the third inserts an event, and the last reads the agenda again to confirm the change.
The date values in the source are examples. The agent should use the dates you actually mean. Read the commands so you know what the agent is doing on your behalf.
gws calendar +agenda
gws calendar freebusy query --json '{"timeMin": "2025-01-20T00:00:00Z", "timeMax": "2025-01-25T00:00:00Z", "items": [{"id": "primary"}]}'
gws calendar +insert --summary 'Deep Work Block' --start '2026-01-21T14:00:00' --end '2026-01-21T16:00:00'
gws calendar +agendaSafety notes: scripts and network access
The skill runs scripts and uses the network. It reads and writes your Google Calendar through gws, so your calendar data is sent to and from Google.
The source does not describe a confirmation step. The recipe adds events directly. Before you rely on it, check your calendar afterwards and decide whether you are comfortable with the agent writing to it.
Avoid using it on shared or work calendars. Adding an event there could notify colleagues or clash with other people's bookings. Do not use it if you want the agent to make no changes at all.
- Runs scripts: yes
- Uses the network: yes
- Writes real events directly, with no confirmation step described in the file
- Avoid shared or work calendars
Tips for getting good results
Ask for one clear thing at a time, such as a single focus block on a given day. This makes it easier to check the result.
Use the review step. Ask the agent to show the updated schedule after it adds events, so you can confirm what was written.
- Name the block you want, for example Deep Work or errands
- Give a specific day and time window
- Check the agenda after every change
What people use it for
- Protecting a two-hour deep work block in a busy week
- Finding a free afternoon and adding an errands block
- Spotting open slots before adding a focus block on a specific day
Frequently asked questions
What do I need to install before using this skill?
You need the gws command-line tool (Google Workspace CLI), the gws-calendar skill, which the recipe lists as a prerequisite, and a Google account authorised for Calendar access through gws. The skill only works with Google Calendar.
Where do I put the skill files?
For a personal install, place the unzipped folder in ~/.claude/skills/. For a single project, place it in that project's .claude/skills/ folder. In the Claude apps you can upload it under Settings → Capabilities → Skills.
Does the skill ask me to confirm before adding events?
The skill file does not describe a confirmation step. The recipe adds events directly, so check your calendar afterwards and be cautious on shared or work calendars.
Can this skill work with Outlook or Apple Calendar?
No. The steps only work with Google Calendar, and the skill cannot read other calendar services.
Is the skill free to use?
The source is licensed under Apache-2.0. Check the licence terms on the page for details of what that allows, and note that the gws tool is a separate requirement.
What should I do if the agent cannot read my calendar?
Confirm that the gws command-line tool is installed and that your Google account is authorised for Calendar access through gws. Also confirm the gws-calendar skill is available, since the recipe depends on it.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
This skill suits people who use Google Calendar and want an agent to find open slots and add focus or errand blocks with little effort. It is a poor fit for anyone on other calendar services, for shared or work calendars where new events could affect colleagues, or for anyone who wants the agent to make no changes, because it writes events directly.
Download the skill