timebox

Timebox todos into free Google Calendar slots and schedule recurring strategic blocks.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/jay-stacey/claude-plugins --skill timebox-jay-stacey
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: timebox
Source: https://github.com/jay-stacey/claude-plugins/tree/main/plugins/executive-assistant/skills/timebox
Command: npx skills add https://github.com/jay-stacey/claude-plugins --skill timebox-jay-stacey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Overloaded calendars and unscheduled to-do lists make daily planning chaotic. This Skill analyzes your Google Calendar, finds free slots, timeboxes today's todos into them, schedules recurring strategic focus blocks, and flags scheduling bottlenecks. ## Core Features & Use Cases - Calendar Analysis & Bottleneck Detection: Runs a calendar review to surface scheduling conflicts and overloaded periods before proposing changes. - Automated Timeboxing: Places today's todos into available calendar slots and creates recurring strategic blocks, respecting protected time and working hours from config. - Safe Scheduling Controls: Dry-run mode, analyze-only mode, and explicit approval rules ensure no event is created without consent and existing events are never moved or deleted. - Use Case: Each morning, ask the assistant to plan your day — it reviews your calendar, identifies free slots, proposes timeboxed blocks for your todos, and creates them only after your approval. ## Quick Start Ask the assistant to timebox today's todos into my free calendar slots using a dry run first.

Frequently Asked Questions about timebox

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

FAQPage Schema
How do I timebox my todos into my Google Calendar?▼

Run the timebox skill and it analyzes your calendar for free slots, then proposes timeboxed blocks for today's todos. Nothing is created until you approve the plan, or you can use --dry-run to preview it first.

How to schedule recurring focus blocks on Google Calendar automatically?▼

Use the --strategic-only flag to schedule recurring strategic blocks without timeboxing todos. The --auto-approve-focus flag creates focus blocks without per-event confirmation, while still respecting protected time and working hours from your config.

Does the timebox skill require any external services?▼

Yes, it requires the Google Workspace MCP server for Google Calendar access, with allowed tools scoped to mcp__google-workspace__*. It runs as a forked calendar-assistant agent using the opus model.

Can the timebox skill modify or delete my existing calendar events?▼

No, the skill only adds new events and never moves or deletes existing ones. It also never creates an event without explicit approval unless an --auto-approve-* flag is set, and --dry-run overrides all auto-approve flags.

What flags does the timebox command support?▼

Supported flags are --dry-run, --analyze-only, --today-only, --strategic-only, --this-week, --this-month, and --auto-approve-focus. Unrecognized arguments are ignored with a notice.