Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

recipe-block-focus-time — Claude Code skill: how to install

Sets up recurring focus time blocks in Google Calendar to protect deep work hours. Works directly through the gws CLI tool.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add googleworkspace/cli --skill recipe-block-focus-time -a claude-code
Open on GitHub

What recipe-block-focus-time does

This skill configures automated focus slots in your primary Google Calendar. It inserts a recurring event named Focus Time from Monday to Friday with opaque status, ensuring teammates see you as busy during deep work windows.

Under the hood, the recipe executes gws calendar events insert with JSON parameters specifying start time, end time, and weekday recurrence rules. It then checks the calendar state by calling gws calendar +agenda. Running this recipe requires the gws binary and the gws-calendar skill.

Install this recipe if you schedule your calendar commitments through Google Workspace command-line tools. Without the gws executable available in your path, the commands cannot complete.

What it helps with

  • block recurring focus time slots on Google Calendar
  • mark weekday deep work hours as busy
  • verify calendar availability using the gws agenda command

Example prompts for the agent

  • Block focus time on my Google Calendar for weekday mornings
  • Schedule a recurring deep work block using gws
  • Protect my morning hours for deep work from Monday to Friday

How to install recipe-block-focus-time

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill recipe-block-focus-time -a claude-code

2Manually: put the files in place

~/.claude/skills/recipe-block-focus-time/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/recipe-block-focus-time/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs

Similar

Questions about recipe-block-focus-time

How do I install recipe-block-focus-time in Claude Code?

Run npx skills add googleworkspace/cli --skill recipe-block-focus-time -a claude-code. The recipe will be stored at ~/.claude/skills/recipe-block-focus-time/SKILL.md.

What does recipe-block-focus-time do?

It inserts a recurring weekday Focus Time event into your primary calendar using gws calendar events insert and confirms the schedule with gws calendar +agenda.

What are the prerequisites for recipe-block-focus-time?

You need the gws binary installed and the gws-calendar skill loaded before executing this recipe.

Source text

SKILL.md · Apache-2.0
---
name: recipe-block-focus-time
description: "Create recurring focus time blocks on Google Calendar to protect deep work hours."
metadata:
  version: 0.22.5
  openclaw:
    category: "recipe"
    domain: "scheduling"
    requires:
      bins:
        - gws
      skills:
        - gws-calendar
---

# Block Focus Time on Google Calendar

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

Create recurring focus time blocks on Google Calendar to protect deep work hours.

## Steps

1. Create recurring focus block: `gws calendar events insert --params '{"calendarId": "primary"}' --json '{"summary": "Focus Time", "description": "Protected deep work block", "start": {"dateTime": "2025-01-20T09:00:00", "timeZone": "America/New_York"}, "end": {"dateTime": "2025-01-20T11:00:00", "timeZone": "America/New_York"}, "recurrence": ["RRULE:FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR"], "transparency": "opaque"}'`
2. Verify it shows as busy: `gws calendar +agenda`

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor