Todo discipline
Skill frankxai/awesome-hermes-agent-skills/skills/todo-discipline
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.From its SKILL.md
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.
- 4 stars4 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 file declares
Copied from the file, not written here
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.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.