← Back to Skills Marketplace
Weekly Planner
by
Tristan Manchester
· GitHub ↗
· v1.0.0
518
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install weekly-planner
Description
File-based weekly planner using TOML for inbox capture, time-block scheduling, weekly review, task rollover, and optional calendar export or Google Calendar...
Usage Guidance
This skill appears to do what it says: it reads and writes planner/*.toml files and provides utilities to create/rollover/validate weeks and to export .ics files. Things to consider before installing or running: 1) Scripts require Python 3.11+ (tomllib) — confirm your environment. 2) Google Calendar sync is optional and runs the external 'gog' CLI via subprocess; only enable calendar writes if you intentionally set config.calendar.write_enabled = true and run sync_week.py with --apply. Do not point planner_calendar_id at your primary calendar unless you want the planner to create/update/delete events there. 3) The SKILL metadata suggests installing gogcli from a third‑party Homebrew tap (steipete/tap) — review that tool before installing. 4) As with any workspace script, review the included Python files (they are short, local, and readable) before running; they do not contain hidden network endpoints or require secrets. 5) Run operations in a controlled workspace (or a copy) the first time to verify behavior.
Capability Analysis
Type: OpenClaw Skill
Name: weekly-planner
Version: 1.0.0
The skill is generally well-designed and includes several safety mechanisms, such as dry-run modes and explicit write-enabled flags for calendar synchronization. The `SKILL.md` instructions are clear and do not contain obvious prompt injection attempts. However, the `scripts/init_planner.py` script is classified as suspicious due to its use of `shutil.rmtree(target_dir)` on a user-controlled `--target` path, especially when combined with the `--force` flag. While the script warns that `--force` is 'DANGEROUS', an agent could be prompted to provide a malicious target path (e.g., `--target / --force`), potentially leading to significant data loss or system disruption. This represents a high-impact vulnerability rather than intentional malice.
Capability Assessment
Purpose & Capability
The name/description (weekly planner, TOML files, inbox capture, time-blocking, optional calendar export/sync) matches the included files and scripts (new_week.py, rollover_week.py, validate.py, export_ics.py, sync_week.py, init_planner.py). There are no unexpected required binaries or environment variables declared. The optional Google sync (via a gog CLI) is explicitly documented and therefore appropriate for the described calendar feature.
Instruction Scope
SKILL.md instructs the agent to inspect and manipulate files inside a planner/ workspace (config.toml, inbox.toml, weeks/*.toml, etc.) and to run the included Python scripts. This stays within the planner scope. Note: sync_week.py invokes the external 'gog' CLI via subprocess for Google Calendar operations — that is documented and optional, but it means calendar changes only happen if the user installs/configures gog and enables writes (config.write_enabled + --apply).
Install Mechanism
No automatic install spec is required to run the scripts (they're included), but SKILL.md metadata suggests brew formulas as convenience (python and steipete/tap/gogcli). Using a brew formula is normal; the gogcli formula comes from a third‑party tap (steipete/tap) — traceable but not a core official homebrew formula. No arbitrary downloads or archive extraction are present in the package.
Credentials
The skill declares no required environment variables, no secret inputs, and no config paths outside the planner/ folder. Calendar sync uses a local gog CLI and planner/config.toml settings (planner_calendar_id and write_enabled) rather than requiring raw tokens in env vars. That is proportionate to its purpose.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide agent settings, and only writes files under the planner/ workspace (or the .ics output path). It does not claim permanent elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install weekly-planner - After installation, invoke the skill by name or use
/weekly-planner - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Weekly Planner 1.0.0 – Initial release: modern, file-based weekly planning for focused week-by-week productivity.
- Inbox capture, weekly plan/schedule, and end-of-week review, all as plain TOML files.
- Fast triage: capture tasks, convert to focus outcomes, and block time with minimal friction.
- Rollover and runbook support: carry forward unfinished work and recurring weekly tasks.
- Optional safe calendar publishing: Google Calendar sync (via gogcli, dry-run/explicit apply only) or .ics export.
- Designed for minimal, human-readable files—no database required.
Metadata
Frequently Asked Questions
What is Weekly Planner?
File-based weekly planner using TOML for inbox capture, time-block scheduling, weekly review, task rollover, and optional calendar export or Google Calendar... It is an AI Agent Skill for Claude Code / OpenClaw, with 518 downloads so far.
How do I install Weekly Planner?
Run "/install weekly-planner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Weekly Planner free?
Yes, Weekly Planner is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Weekly Planner support?
Weekly Planner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Weekly Planner?
It is built and maintained by Tristan Manchester (@tristanmanchester); the current version is v1.0.0.
More Skills