claude-todo-md-skill
anh-chu/claude-todo-md-skill
Claude Code skill for managing a TODO.md file co-owned with a pi coding agent (pi-todo-md), with zero format drift
Instalação
npx convez-ai anh-chu/claude-todo-md-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
todo-md (Claude Code skill)
A Claude Code skill for managing a repo-local
TODO.md file that is co-owned by a pi
coding agent running the pi-todo-md extension.
The point is zero format drift: every change Claude makes is byte-identical to what
pi would write, so the two agents can work on the same TODO.md without clobbering each
other's formatting. It does this by driving all mutations through pi's own engine
(the exact same executeTodoActionOnFile code path pi uses) instead of hand-editing.
Requirements
- pi-todo-md installed (
pi install npm:pi-todo-md). The skill reuses pi's engine; it does not reimplement the format. - Node.js >= 20.
Install
With the skills CLI (installs SKILL.md
and the todo.mjs helper together):
npx skills add anh-chu/claude-todo-md-skill -g -a claude-code
Or clone directly into your Claude Code skills directory:
git clone https://github.com/anh-chu/claude-todo-md-skill.git ~/.claude/skills/todo-md
That's it. Start Claude Code in a project and just ask:
Show me the current todo listAdd a task to publish the plugin, high priorityMark task #3 as doneFocus task #2 and add a note to publish after docs landArchive completed tasks
How it resolves pi's engine
todo.mjs finds pi's pi-todo-md engine in this order:
PI_TODO_MD_SRCenv var, if set (path topi-todo-md/src/todo-md.js)- Node module resolution of
pi-todo-md/src - Default pi install path:
~/.pi/agent/npm/node_modules/pi-todo-md/src/todo-md.js
License
MIT. The pi-todo-md engine it calls is MIT-licensed by its authors and is not vendored here.