mirror of
https://github.com/hanzoskill/todo-tracker.git
synced 2026-10-30 21:11:44 +00:00
main
π TODO Tracker Skill
A persistent TODO scratch pad for Bot that tracks tasks across sessions with priorities, completion tracking, and heartbeat reminders.
Installation
# Clone to your skills folder
git clone https://github.com/jdrhyne/todo-tracker-skill.git skills/todo-tracker
Or copy SKILL.md and scripts/ to your Bot workspace.
Usage
Just talk naturally to your agent:
| Say this... | What happens |
|---|---|
| "Add X to TODO" | Adds item (default: medium priority) |
| "Add X to high priority TODO" | Adds as high priority |
| "What's on the TODO?" | Shows the list |
| "Mark X done" | Moves item to Done section |
| "Remove X from TODO" | Deletes the item |
Priorities
- π΄ High β Urgent items
- π‘ Medium β Normal priority (default)
- π’ Nice to Have β Low priority / future ideas
TODO.md Format
The skill maintains a TODO.md file in your workspace:
# TODO - Scratch Pad
*Last updated: 2026-01-17*
## π΄ High Priority
- [ ] Important task (added: 2026-01-17)
## π‘ Medium Priority
- [ ] Regular task (added: 2026-01-17)
## π’ Nice to Have
- [ ] Future idea (added: 2026-01-17)
## β
Done
- [x] Completed task (done: 2026-01-17)
CLI Commands
The skill includes a bash script for direct use:
# Add items
bash scripts/todo.sh add high "Urgent task"
bash scripts/todo.sh add medium "Normal task"
bash scripts/todo.sh add low "Nice to have"
# Mark done (matches partial text)
bash scripts/todo.sh done "Urgent"
# Remove item
bash scripts/todo.sh remove "old task"
# List all
bash scripts/todo.sh list
# Quick summary (great for heartbeats)
bash scripts/todo.sh summary
Heartbeat Integration
Add this to your HEARTBEAT.md to get reminders:
## Active Monitoring Tasks
### Daily TODO Check
On each heartbeat:
- Run: bash skills/todo-tracker/scripts/todo.sh summary
- If high-priority items exist, mention them
- Flag stale items (>7 days old)
Example Summary Output
π TODO: 7 items (2 high, 2 medium, 3 low)
π΄ High priority items:
β’ Ingest low-code docs
β’ Fix critical bug
β οΈ 1 stale item (>7 days old)
License
MIT β use freely!
Made for Bot π€
Languages
Shell
100%