todo-tracker – OpenClaw Skill

---

name: todo-tracker description: Persistent TODO scratch pad for tracking tasks across sessions. Use when user says "add to TODO", "what's on the TODO", "mark X done", "show TODO list", "remove from TODO", or asks about pending tasks. Also triggers on heartbeat to remind about stale items.

TODO Tracker

Maintain a persistent TODO.md scratch pad in the workspace.

File Location

TODO.md in workspace root (e.g., /Users/nuthome/nuri-bot/TODO.md)

Commands

View TODO

When user asks: "what's on the TODO?", "show TODO", "pending tasks?"

cat TODO.md

Then summarize the items by priority.

Add Item

When user says: "add X to TODO", "TODO: X", "remember to X"

bash skills/todo-tracker/scripts/todo.sh add "<priority>" "<item>"

Priorities: high, medium, low (default: medium)

Examples:

bash skills/todo-tracker/scripts/todo.sh add high "Ingest low-code docs"
bash skills/todo-tracker/scripts/todo.sh add medium "Set up Zendesk escalation"
bash skills/todo-tracker/scripts/todo.sh add low "Add user memory feature"

Mark Done

When user says: "mark X done", "completed X", "finished X"

bash skills/todo-tracker/scripts/todo.sh done "<item-pattern>"

Matches partial text. Moves item to ✅ Done section with date.

Remove Item

When user says: "remove X from TODO", "delete X from TODO"

bash skills/todo-tracker/scripts/todo.sh remove "<item-pattern>"

List by Priority

bash skills/todo-tracker/scripts/todo.sh list high
bash skills/todo-tracker/scripts/todo.sh list medium
bash skills/todo-tracker/scripts/todo.sh list low

Heartbeat Integration

On heartbeat, check TODO.md:

1. Count high-priority items
2. Check for stale items (added >7 days ago)
3. If items exist, include brief summary in heartbeat response

Example heartbeat check:

bash skills/todo-tracker/scripts/todo.sh summary

TODO.md Format

# TODO - Nuri Scratch Pad

*Last updated: 2026-01-17*

## 🔴 High Priority
- [ ] Item one (added: 2026-01-17)
- [ ] Item two (added: 2026-01-15) ⚠️ STALE

## 🟡 Medium Priority
- [ ] Item three (added: 2026-01-17)

## 🟢 Nice to Have
- [ ] Item four (added: 2026-01-17)

## ✅ Done
- [x] Completed item (done: 2026-01-17)

Response Format

When showing TODO:

📋 **TODO List** (3 items)

🔴 **High Priority** (1)
• Ingest low-code docs

🟡 **Medium Priority** (1)  
• Zendesk escalation from Discord

🟢 **Nice to Have** (1)
• User conversation memory

⚠️ 1 item is stale (>7 days old)

📋 TODO Tracker Skill

A persistent TODO scratch pad for Clawdbot 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 Clawdbot 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 Clawdbot 🤖