recipe-block-focus-time

Creates recurring focus time blocks on Google Calendar using the gws CLI.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill recipe-block-focus-time-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recipe-block-focus-time
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/recipe-block-focus-time
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill recipe-block-focus-time-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deep work hours often get consumed by meetings because calendars lack protected time. This Skill automates the creation of recurring focus time blocks on Google Calendar so those hours appear as busy to colleagues and scheduling tools. ## Core Features & Use Cases - Recurring Event Creation: Inserts a weekly recurring "Focus Time" event (Monday through Friday) on the primary Google Calendar via the gws CLI. - Busy Status Protection: Sets the event transparency to opaque so the block shows as busy and prevents meeting conflicts. - Verification Step: Confirms the block appears correctly using the gws calendar agenda command. - Use Case: A knowledge worker wants 9:00-11:00 AM every weekday reserved for deep work; this Skill creates that recurring block in one command. ## Quick Start Ask the assistant to create a recurring weekday focus time block from 9 to 11 AM on your primary Google Calendar using the gws calendar tool.

Frequently Asked Questions about recipe-block-focus-time

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a recurring event on Google Calendar from the command line?

Use the gws calendar events insert command with a JSON body containing summary, start and end dateTime values, and a recurrence field with an RRULE string such as FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR. The event is added to the specified calendarId, typically primary.

How do I block focus time so it shows as busy on Google Calendar?

Set the event's transparency property to opaque when inserting the event. Opaque events mark the time slot as busy, so colleagues and scheduling tools see the focus block as unavailable for meetings.

What tools are required to run this focus time recipe?

The recipe requires the gws CLI binary installed on the system and the gws-calendar skill loaded as a prerequisite. Both are declared in the skill's metadata under openclaw requires.

How can I verify a calendar event was created successfully?

Run gws calendar +agenda after inserting the event. This command displays upcoming agenda items, letting you confirm the focus block appears on the expected dates and shows as busy.

Can I change the time zone or days of the recurring focus block?

Yes, edit the timeZone field in the start and end objects and modify the BYDAY values in the RRULE recurrence string. The example uses America/New_York with Monday through Friday, but any valid IANA time zone and weekday combination works.