How do I install the Todo skill?

Run npx skillmds@latest add lord1egypt/todo in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Todo?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Lord1Egypt (@lord1egypt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Todo by lord1egypt — Agent Skill

Name: Todo
Rating: 4.2 (5 reviews)
Author: Lord1Egypt

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.

Lord1Egypt Updated Sep 8, 2026 2 repo stars

File contents

Todo: Offload the weight. Keep the momentum.

Core Philosophy

Capture pressure before it turns into anxiety.
Surface momentum, not accumulated guilt.
Recommend one clear next step, not an overwhelming list.
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

---name: tododescription: 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.---# Todo: Offload the weight. Keep the momentum.## Core Philosophy1. 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## StorageAll 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 |

Frequently asked questions