← Back to Skills Marketplace
278
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install suidge-todo-tracker
Description
Manage follow-up items and remind users at appropriate times via heartbeat checks.
Usage Guidance
This skill appears coherent and limited to local todo management, but before installing: 1) verify the workspace layout on your agent matches the script's TODO_FILE path (the cleaner uses a relative path up from scripts to workspace/memory/todo.json); 2) run the cleaner in --dry-run first to confirm it targets the intended file; 3) ensure your agent will set completed_at / cancelled_at and reminded flags as required (the cleanup depends on completed_at); 4) review HEARTBEAT.md and AGENTS.md changes you are asked to make to confirm you want automatic heartbeat-driven reminders; and 5) if provenance matters, check the referenced GitHub repo/owner (SKILL.md/footer lists a GitHub URL) since the top-level metadata listed the source as unknown. If any of these checks fail or the workspace layout differs, treat installation as potentially disruptive until corrected.
Capability Analysis
Type: OpenClaw Skill
Name: suidge-todo-tracker
Version: 1.2.0
The skill bundle is a standard todo tracking system that allows an AI agent to manage follow-up tasks. The included Python script, `scripts/todo-cleaner.py`, is a straightforward utility for pruning old entries from a local JSON file using standard libraries, with no network activity or shell execution. The instructions in `SKILL.md` and `setup.md` are consistent with the stated purpose and do not contain any malicious prompt injection or unauthorized data access patterns.
Capability Assessment
Purpose & Capability
The name/description (todo reminders, heartbeat-driven checks) matches the included files and behavior. There are no unrelated required binaries, env vars, or external services. The provided cleanup script and templates are appropriate for a self-managed todo skill.
Instruction Scope
SKILL.md instructs the agent to copy templates to memory/todo.json, register heartbeat and trigger keywords, and follow clear rules for marking items. The instructions reference only workspace files (memory/todo.json, HEARTBEAT.md, AGENTS.md) and do not ask the agent to read or exfiltrate unrelated files or secrets.
Install Mechanism
No install spec is provided (instruction-only) and the only code file is a small local Python script. Nothing is downloaded from external URLs or installed from remote package registries.
Credentials
The skill requires no environment variables, credentials, or config paths. The only persistent state is a JSON file in the agent workspace, which matches the skill's purpose.
Persistence & Privilege
The skill does not request 'always: true' and uses normal autonomous invocation via heartbeat triggers (the platform default). It does not attempt to modify other skills or system-wide settings programmatically.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install suidge-todo-tracker - After installation, invoke the skill by name or use
/suidge-todo-tracker - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
v1.2.0 - Added HARD CONSTRAINTS section: marking completed/cancelled MUST set completed_at/cancelled_at fields
- Added a mandatory rule: when marking a todo as completed or cancelled, you must set the completed_at or cancelled_at timestamp field (ISO 8601 with timezone).
- Explained the importance: cleanup script will skip items missing these fields, leaving them undeleted.
- Updated documentation with examples and emphasized these constraints for correct todo lifecycle management.
v1.1.0
v1.1.0 - Added cleanup script (scripts/todo-cleaner.py) for auto-deleting completed items after 24h
- New: Added scripts/todo-cleaner.py to automatically delete completed/cancelled items older than 24 hours.
- Updated documentation (SKILL.md) with instructions and new quick reference for the cleanup script.
- Clarified heartbeat reminder policy in Core Rules.
v1.0.1
Fix: update slug references
v1.0.0
Todo Tracker 1.0.0 — Initial release
- Manage follow-up items and reminders via heartbeat checks.
- Store todos in `memory/todo.json` with fields for id, description, follow-up time, status, priority, and context.
- Remind users of pending items during 30-minute heartbeat intervals and prevent duplicate reminders.
- Automatically clean up completed or cancelled items after 24 hours.
- Support natural-language keywords to add, list, complete, or cancel todos.
- Prompts users for missing info when setting reminders.
Metadata
Frequently Asked Questions
What is Todo Tracker?
Manage follow-up items and remind users at appropriate times via heartbeat checks. It is an AI Agent Skill for Claude Code / OpenClaw, with 278 downloads so far.
How do I install Todo Tracker?
Run "/install suidge-todo-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Todo Tracker free?
Yes, Todo Tracker is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Todo Tracker support?
Todo Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux, darwin, win32).
Who created Todo Tracker?
It is built and maintained by Neo Shi (@suidge); the current version is v1.2.0.
More Skills