[hax] store a todo skill

1 files changed, 16 insertions, 0 deletions

diff --git a/skills/todo/SKILL.md b/skills/todo/SKILL.md
new file mode 100644
index 0000000..8e9d815
--- /dev/null
+++ b/skills/todo/SKILL.md
@@ -0,0 +1,16 @@
+---
+description: Track a per-session todo list when a task has several steps to add, check off, or remove.
+---
+
+Run the script next to this file to keep a todo list for the current session:
+
+```sh
+~/.config/hax/skills/todo/todo.py {list [ID...] | add TEXT | done [ID...] | remove [ID...]}
+```
+
+- `list` prints a truncated view of every item; `list ID...` prints just those fully.
+- `add TEXT` appends an item.
+- `done ID...` marks items done; `remove ID...` deletes them.
+- Items have stable ids, shown in the output and never reused, so they stay valid across additions and removals. `add`/`done`/`remove` echo the last few items so you can confirm ids without a separate `list`.
+- Bulk views truncate long text; `list ID...` and the per-item reports of `done`/`remove` show the full text. Stored text is always intact.
+- Keep items short. Use this only for genuine multi-step work, not for a single action.