A developer-friendly, file-based weekly planning system using TOML to manage tasks, time blocks, and calendar syncs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install weekly-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 weekly-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 Weekly Planner?
The Weekly Planner is a lightweight, text-based productivity system designed to integrate directly into your development workspace. By leveraging TOML files, it provides a structured environment for inbox capture, detailed weekly planning, and performance reviews. This skill allows users to maintain a high-context schedule that is both human-readable and machine-parsable, ensuring that your planning workflow remains as efficient as your code.
As part of the Openclaw Skills ecosystem, this tool emphasizes data ownership and automation. It enables you to transform a messy inbox of tasks into a cohesive weekly strategy, complete with time-blocked focus sessions and automated rollovers of unfinished work. Whether you prefer local file management or cloud-based calendar integration, this skill adapts to your specific professional workflow.
Weekly Planner Use Cases
- Creating structured weekly plans with specific outcomes and focus tasks.
- Rapidly capturing tasks into a centralized inbox with minimal friction.
- Converting inbox items into scheduled time blocks or unscheduled daily bits.
- Synchronizing your weekly schedule with Google Calendar or exporting to .ics files.
- Performing end-of-week reviews to track scores, wins, and learnings for continuous improvement.
How Weekly Planner Works
- Initialize the planner directory to create the necessary TOML configuration and script files.
- Capture incoming tasks and ideas into the append-only inbox file.
- Run the triage process to move inbox items into a specific weekly plan file based on priority and mode.
- Use Python-based automation scripts to generate new weeks or roll over incomplete tasks from the previous period.
- Validate the weekly plan to ensure there are no scheduling overlaps or missing metadata.
- Export the final schedule to a calendar system for real-time visibility and notifications.
Weekly Planner Setup
To start using this skill within the Openclaw Skills framework, ensure you have Python 3.11+ installed. Initialize your planner folder with the following command:
python3 {baseDir}/scripts/init_planner.py --target ./planner
If you plan to use Google Calendar synchronization, install the required CLI tool:
brew tap steipete/tap
brew install gogcli
Finally, customize your planner/config.toml with your local timezone and preferred work modes.
Weekly Planner Data Schema & Taxonomy
The skill organizes productivity data through a clean directory structure and TOML schema:
| File Path | Description | Schema Elements |
|---|---|---|
planner/inbox.toml |
Raw task capture | created, text, mode, priority, status |
planner/weeks/*.toml |
Weekly schedule | goals, focus_tasks, time_blocks, review |
planner/config.toml |
Global settings | timezone, modes, calendar.write_enabled |
planner/runbook.toml |
Recurring tasks | [[time_blocks]] templates |
planner/modes/*.md |
Workflow context | Markdown descriptions of work styles |
Weekly Planner Advanced Features
- Automated rollover logic that intelligently migrates unfinished 'bits' to the next planning cycle.
- Destructive sync safety latches requiring explicit user permission and configuration before modifying external calendars.
- Built-in validation engine that identifies schedule conflicts, out-of-bounds blocks, and unknown mode tags.
- Support for custom Mode Cards that allow the AI agent to understand how to handle different types of tasks (e.g., deep work vs. admin).
- Flexible export options including direct Google Calendar API integration via gogcli or standard .ics file generation.
SKILL.md
Loading
Related Openclaw Skills
track17
A comprehensive parcel tracking integration that connects AI agents to the 17TRACK API for real-time shipment monitoring and local data persistence.
Todoist API Skill
A comprehensive CLI and automation toolkit for managing Todoist tasks, projects, and workflows via the Todoist API v1.
Reddit Readonly
A specialized tool for searching subreddits and extracting comment threads via public JSON endpoints without requiring authenticated API access.
Notion Management Skill
A JSON-first CLI skill for managing Notion pages, databases, and Markdown content with deterministic script execution.
Wordly Wisdom
A calibrated decision-making engine for AI agents based on Charlie Munger's mental models and disciplined judgment techniques.
SearXNG Search Skill
A privacy-respecting metasearch skill that aggregates results from Google, Bing, and DuckDuckGo via a self-hosted SearXNG instance.
Featured*
