Todo

Personal execution engine for tasks, projects, reminders, commitments, follow-ups, and next actions. Use whenever the user mentions something they need to do...

Security Scan

The skill is internally consistent: it implements a local, Python-based todo system that only reads/writes files under ~/.openclaw/workspace/memory/todo and requires no external credentials or network access.

Purpose & Capability

Name/description align with the included scripts: capture, scoring, what-next recommendation, daily/weekly workflows, archiving, and local storage initialization. The only runtime dependency (python3) is reasonable and declared in SKILL.md.

Instruction Scope

Runtime instructions and scripts only operate on local files under ~/.openclaw/workspace/memory/todo; they do not reference external endpoints, unrelated system paths, or undeclared environment variables. The actions (add/update/archive/review/score) match the stated purpose.

Install Mechanism

No install spec is provided (instruction-only). All code is bundled in the skill and there are no download/install steps from remote URLs, package registries, or extract operations.

Credentials

The skill declares no required environment variables or credentials and the scripts do not read environment secrets. Access is limited to the user's home directory path under ~/.openclaw/workspace/memory/todo.

Persistence & Privilege

always is false and the skill does not attempt to modify other skills or global agent settings. It persists only its own data files and metadata in a single directory under the user's home.

Assessment

This skill appears safe and coherent: it runs locally using python3 and stores data under ~/.openclaw/workspace/memory/todo. Before installing, verify you are comfortable with the skill creating and updating files in that path, and optionally inspect the bundled scripts yourself (they are plain Python and contain no network calls). Make backups of any existing ~/.openclaw data you care about. Because the skill is allowed to be invoked by the agent (normal default), consider whether you want the agent to call it autonomously; the skill is not set to always run and does not request credentials or external access.

Todo: Offload the weight. Keep the momentum.

Core Philosophy

1. Capture pressure before it turns into anxiety.
2. Surface momentum, not accumulated guilt.
3. Recommend one clear next step, not an overwhelming list.
4. Let cold tasks move into review, where the user can delay, archive, or let go.

Runtime Requirements

• Python 3 must be available as python3
• No external packages required

Storage

All data is stored locally only under:

• ~/.openclaw/workspace/memory/todo/items.json
• ~/.openclaw/workspace/memory/todo/stats.json
• ~/.openclaw/workspace/memory/todo/archive.json

No external sync. No cloud storage. No third-party task APIs.

Item Types

• task: A concrete action.
• project: A multi-step outcome that should be broken into next actions.
• commitment: A promise or obligation to someone else.
• follow_up: Something that needs to be checked on, nudged, or revisited.
• reminder: A lightweight remember-later item.

Item Traits

• tiny: 2-5 minute action with low friction.
• hot: Fresh, recently captured, or recently touched.
• cold: Stale item that should move into review unless urgent.
• blocked: Cannot move forward yet.
• waiting: Pending someone else.

Key Workflows

• Capture: add_item.py --title "..." with inferred metadata.
• What Next: what_next.py returns 1 Top Pick and 2 Backups, each with a humanized prefix and short reason.
• Daily Sync: daily_sync.py summarizes completed work and mental weight released.
• Weekly Review: weekly_review.py revives, delays, archives, or lets go of cold items.

Scripts

Script	Purpose
add_item.py	Capture a new item into the system
what_next.py	Recommend the best next action
update_item.py	Update status and metadata
daily_sync.py	Summarize progress and mental weight released
weekly_review.py	Review, delay, archive, or let go of cold items
archive_item.py	Move an item into archive
refresh_scores.py	Recalculate hot/warm/cold scores
init_storage.py	Initialize local storage files