Persistent task management via TODO.md. Supports add, complete, list, delete, and heartbeat integration.
Treat TODO.md as the single source of truth for task management in the workspace.
Track tasks across sessions and alert on high-priority or overdue tasks during heartbeats.
Use this skill autonomously when the following apply:
When explicitly requested by the user:
When the agent autonomously determines it's needed:
During heartbeats:
HEARTBEAT_OKManage in the following format:
TODO.md# TODO
## High Priority 🔴
- [ ] Task name <!-- added: 2026-02-23 -->
- [x] Completed task <!-- added: 2026-02-20, done: 2026-02-21 -->
## Medium Priority 🟡
- [ ] Task name <!-- added: 2026-02-23 -->
## Low Priority 🟢
- [ ] Task name <!-- added: 2026-02-23 -->
geminiclaw_status to get today's dateTODO.md (if it doesn't exist, create a new one using the format above)<!-- added: YYYY-MM-DD --> comment and saveTODO.md[ ] to [x] for the relevant task and append <!-- added: ..., done: YYYY-MM-DD -->TODO.md (if it doesn't exist, respond "No TODOs found")TODO.mdDuring heartbeat execution, perform the following before returning HEARTBEAT_OK:
TODO.md (if it doesn't exist, skip and return HEARTBEAT_OK as normal)added date is more than 7 days agoHEARTBEAT_OK; instead output an alert in the following format:
📋 TODO: N high-priority, M stale (>7 days)
- [task name] (added: YYYY-MM-DD)
- ...
HEARTBEAT_OK as normal (TODO check is silent)