# Todo

> Use when adding, completing, listing, or cleaning project tasks in `docs/TODO.md`. Triggers on "todo", "记一下", "待办", "回头要", "add a todo".

- Skill: `freemty/todo` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add freemty/todo`
- Raw SKILL.md: https://api.skillmd.com/api/skills/freemty/todo/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: freemty (https://skillmd.com/u/freemty)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/freemty/todo

---


# Todo

Resolve `<plugin-root>` and use the typed CRUD interface:

```bash
python3 <plugin-root>/scripts/todo.py add "<task>" --priority P1
python3 <plugin-root>/scripts/todo.py done "<unique text>"
python3 <plugin-root>/scripts/todo.py list
python3 <plugin-root>/scripts/todo.py clean
```

Default new tasks to `P1` unless urgency is explicit. If `done` reports multiple
matches, present them and ask the user to disambiguate. Report the JSON result;
do not manually reformat the file behind the script.