Track a multi-step task as a live to-do overlay (tool todo) that survives /reload and conversation compaction. Create/update/list/get/delete/clear tasks with a 4-state machine and blockedBy dependencies.
Installation
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Track a multi-step task as a live to-do overlay (tool todo) that survives /reload and conversation compaction. Create/update/list/get/delete/clear tasks with a 4-state machine and blockedBy dependencies.
disable-model-invocation
true
Todo (Pi)
Provides the todo tool: create / update / list / get / delete / clear tasks. A 4-state machine (pending → in_progress → completed, plus a deleted tombstone), blockedBy dependency tracking with cycle detection, rendered as a live overlay. Tasks persist via branch replay, so they survive session compaction and /reload.
When to use
A task with 3+ distinct steps or multiple files/phases, where tracking progress across turns matters.
Work likely to span a compaction or /reload — the list is the durable memory of what's done and what's left.
When the user hands you a multi-part request and you want to show, and keep, a plan.
Mark exactly one task in_progress at a time; flip it to completed the moment it's done (don't batch completions). Use blockedBy when one step genuinely gates another.
When NOT to use
Single-step or trivial tasks — a todo list is overhead, just do it.
As a substitute for actually doing the work, or to narrate steps you'll do immediately anyway.
