todo

Personal execution engine for tasks, projects, reminders, commitments, follow-ups, and next actions. Use whenever the user mentions something they need to do, remember, plan, follow up on, prioritize, or make progress on. Also use when the user feels overwhelmed, brain-fogged, unsure what to do next, or needs to offload mental strain. This skill captures natural language, turns vague intentions into structured action, tracks momentum, and surfaces the most human-friendly next step. Local-only storage.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "todo" with this command: npx skills add agenticio/todo

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

ScriptPurpose
add_item.pyCapture a new item into the system
what_next.pyRecommend the best next action
update_item.pyUpdate status and metadata
daily_sync.pySummarize progress and mental weight released
weekly_review.pyReview, delay, archive, or let go of cold items
archive_item.pyMove an item into archive
refresh_scores.pyRecalculate hot/warm/cold scores
init_storage.pyInitialize local storage files

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

Todo management

Per-workspace SQLite todo manager (./todo.db) with groups and task statuses (pending/in_progress/done/skipped), operated via {baseDir}/scripts/todo.sh for adding, listing, editing, moving, and removing entries and managing groups.

Registry SourceRecently Updated
4.7K11Profile unavailable
General

bun-do

Manage bun-do tasks and projects — add tasks, edit tasks, delete tasks, toggle done, manage subtasks, and log project progress entries. Use when the user say...

Registry SourceRecently Updated
3860Profile unavailable
Security

Task Runner

Manage and track tasks and projects persistently with priorities, completion status, filtering, and secure markdown export across sessions.

Registry SourceRecently Updated
1.1K1Profile unavailable
Coding

Microsoft To Do

Manage Microsoft To Do tasks via the `todo` CLI. Use when user wants to add, list, complete, remove tasks, manage subtasks (steps), notes, or organize task lists.

Registry SourceRecently Updated
1.5K1Profile unavailable