todo-tracker

Q: How do I install todo-tracker?

Run npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill todo-tracker in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/todo-tracker/ (personal) or .claude/skills/todo-tracker/ (project).

by sundial-orgProductivity & Automation

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.

Installs: 176
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill todo-tracker

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads todo-tracker automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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:

Count high-priority items
Check for stale items (added >7 days ago)
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)

FAQ

What does the todo-tracker skill do?

How do I install todo-tracker?

Run npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill todo-tracker in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/todo-tracker/ (personal) or .claude/skills/todo-tracker/ (project).

Which AI agents can use todo-tracker?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is todo-tracker safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains todo-tracker?

It is published by sundial-org in sundial-org/awesome-openclaw-skills. It has 176 recorded installs.