Todo discipline
Skill frankxai/awesome-hermes-agent-skills/skills/todo-discipline
Awesome list of Hermes-compatible skills & plugins from across the web (+ small free open-core packs) | agents companion: frankxai/awesome-hermes-agents
npx -y skills add frankxai/awesome-hermes-agent-skills --skill todo-disciplineAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when starting any complex task (3+ steps) or before declaring work complete. Enforces todo/task state to match reality — merge updates + read verification. Prevents false completion.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
1.6 KB, 277 tokens by cl100k_base, as published. Nobody here has run it
Todo Discipline (Free)
Agents often create task lists, do the work, then conclude while the UI still shows 0/N done. This skill makes task state = reality a hard gate.
When to Use
- Complex tasks with 3+ steps
- Multi-agent or long sessions
- Before any “done”, handover, or “battle-tested” claim
Don't use for: single-step Q&A.
Hard gate
Before any concluding message:
- Update every finished item to completed (merge, don’t wipe history)
- Immediately read the task list again (no-args read)
- Only then write the final summary
Treat the read result as ground truth if merge responses echo stale state (common in long/headless runs).
Rules
- Prefer merge over full replace
- Only one item
in_progressat a time - Never pass an empty todos array on merge (can clear the list)
- Supply full id + content + new status for items you change
Verification checklist
- All finished work marked completed
- No stale in_progress when claiming done
- Read-back confirmed
- User-visible task counter matches reality
License
MIT — Frank Riemer / GenCreator.