A professional CLI-driven calendar orchestration skill for reconciling work, life, and health across multiple platforms with conflict repair and focus protection.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install calendar-planner
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install calendar-planner using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Calendar Planner?
Calendar Planner is a sophisticated orchestration layer for Openclaw Skills designed for developers and power users who manage multiple calendars. It moves beyond simple event creation by offering a Life Grid planning methodology that treats time as a finite resource. By integrating with Google Calendar, Outlook, Apple Calendar, and CalDAV via CLI adapters, it provides a unified view of your commitments while strictly respecting privacy and user consent.
The skill excels at schedule repair and defensive planning. It doesn't just add meetings; it calculates buffers, identifies hidden risks in overlapping schedules, and ensures that deep work and recovery time are protected against meeting creep. Whether you are managing family logistics or complex work sprints, this skill provides a defended, execution-ready plan while maintaining local continuity for your planning rules.
Calendar Planner Use Cases
- Reconciling conflicting commitments across work (Outlook), personal (Google), and family (Apple) calendars.
- Performing a weekly review and schedule repair when a week becomes overloaded or fragmented.
- Implementing strict time-blocking and focus-rule protection using the Life Grid protocol.
- Automating complex calendar merges and audits via CLI tools like gcalcli, khal, and vdirsyncer.
- Protecting recovery and travel time by automatically calculating and inserting necessary buffers around hard commitments.
How Calendar Planner Works
- Intake & Discovery: The skill analyzes current planning requests and existing calendar state using platform-specific CLI adapters.
- Platform Merging: It runs calendar_merge.py to create a normalized view of all in-scope calendars, revealing hidden conflicts and true capacity.
- Classification: Every item is categorized as hard, flexible, prep, travel, or recovery to determine what can be moved during a repair.
- Conflict Guard: The calendar_guard.py script identifies overlaps, missing buffers, and focus-rule violations.
- Proposal & Review: A defended plan is presented with explicit trade-offs and dry-run command sequences for the user to review.
- Execution: Upon explicit approval, the skill executes the specific CLI commands needed to update the remote providers.
Calendar Planner Setup
To begin using this skill within the Openclaw Skills ecosystem, ensure you have the necessary system dependencies installed on your machine:
# Ensure python3 and jq are installed for local analysis
sudo apt install python3 jq
# Install the specific CLI adapter for your preferred provider
# For Google Calendar:
pip install gcalcli
# For CalDAV or iCloud sync:
pip install khal vdirsyncer
Initialize the local environment by responding to the first planning question. The skill will request permission before creating the ~/calendar-planner/ directory and will never write to your calendars without a specific confirmation for the proposed action.
Calendar Planner Data Schema & Taxonomy
The skill maintains local state in ~/calendar-planner/ to ensure continuity and persistence of your planning heuristics. This data is organized as follows:
| File | Description |
|---|---|
| memory.md | Stores user-stated planning rules and activation preferences |
| calendars.md | Maps provider details, calendar names, and write boundaries |
| rules.md | Defines buffers, focus rules, and recurring constraints |
| plans.md | Tracks current week plans and specific reschedule decisions |
| inbox.md | Captures loose commitments that still need final placement |
Calendar Planner Advanced Features
- Multi-Adapter Orchestration: Seamlessly bridge Google Calendar, Microsoft Graph, and CalDAV within a single unified workflow.
- Life Grid Heuristics: Access domain-specific planning rules that prevent work tasks from silently overrunning family, health, or sleep constraints.
- Defensive Buffering: Automated calculation of setup, commute, and decompression time to ensure your schedule reflects real human capacity.
- Audit & Guard Scripts: Use local Python scripts to catch overlaps and overloaded days before they happen.
- Dry-Run Execution: Generates safe action sequences and draft plans first, keeping you in full control of your shared calendar data.
SKILL.md
Loading
Related Openclaw Skills
Caddy
A comprehensive configuration skill for deploying Caddy as a high-performance reverse proxy with automatic HTTPS management.
C Language Safety & Optimization
A specialized technical skill for writing secure, memory-safe C code while avoiding common pitfalls and undefined behavior.
Buy
A sophisticated purchasing assistant for researching deals, detecting scams, and generating negotiation scripts.
Business Strategy
A strategic advisor skill for AI agents that uses data-driven frameworks to validate business ideas and track critical decision-making.
California
A comprehensive AI guide for navigating the complex logistics of living, working, and traveling across California's diverse regions.
Call Center
A comprehensive framework for AI agents to manage professional voice interactions, scripts, and customer resolution protocols.
Featured*
