todo-tracker
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.
Best use case
todo-tracker is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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.
Teams using todo-tracker should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/todo-tracker/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How todo-tracker Compares
| Feature / Agent | todo-tracker | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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?" ```bash cat TODO.md ``` Then summarize the items by priority. ### Add Item When user says: "add X to TODO", "TODO: X", "remember to X" ```bash bash skills/todo-tracker/scripts/todo.sh add "<priority>" "<item>" ``` Priorities: `high`, `medium`, `low` (default: medium) Examples: ```bash 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 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 bash skills/todo-tracker/scripts/todo.sh remove "<item-pattern>" ``` ### List by Priority ```bash 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 bash skills/todo-tracker/scripts/todo.sh summary ``` ## TODO.md Format ```markdown # 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) ```
Related Skills
Zendesk
Manage Zendesk tickets, users, and support workflows through the Zendesk API. Use when searching tickets, updating support state, checking users, or exporting queue data.
task-orchestrator
Autonomous multi-agent task orchestration with dependency analysis, parallel tmux/Codex execution, and self-healing heartbeat monitoring. Use for large projects with multiple issues/tasks that need coordinated parallel execution.
sysadmin-toolbox
Tool discovery and shell one-liner reference for sysadmin, DevOps, and security tasks. AUTO-CONSULT this skill when the user is: troubleshooting network issues, debugging processes, analyzing logs, working with SSL/TLS, managing DNS, testing HTTP endpoints, auditing security, working with containers, writing shell scripts, or asks 'what tool should I use for X'. Source: github.com/trimstray/the-book-of-secret-knowledge
salesforce
Query and manage Salesforce CRM data via the Salesforce CLI (`sf`). Run SOQL/SOSL queries, inspect object schemas, create/update/delete records, bulk import/export, execute Apex, deploy metadata, and make raw REST API calls.
remotion-best-practices
Best practices for Remotion - Video creation in React
planner
Create structured plans for multi-task projects that can be used by the task-orchestrator skill. Use when breaking down complex work into parallel and sequential tasks with dependencies.
parallel-task
Coordinate plan files by launching multiple parallel subagents for unblocked tasks. Triggers on explicit "/parallel-task" commands.
nutrient-openclaw
OpenClaw-native document processing skill for Nutrient DWS. Use when OpenClaw users need to convert files, extract text or tables, OCR scans, redact PII, watermark PDFs, digitally sign documents, or check credit usage from chat attachments or workspace files. Triggers on OpenClaw tool names (`nutrient_convert_to_pdf`, `nutrient_extract_text`, etc.), "OpenClaw plugin", "Nutrient OpenClaw", and document-processing requests in OpenClaw chats. Files are processed by Nutrient DWS over the network, so use it only when third-party document processing is acceptable. For non-OpenClaw environments, use the universal Nutrient document-processing skill instead.
nudocs
Upload, edit, and export documents via Nudocs.ai. Use when creating shareable document links for collaborative editing, uploading markdown/docs to Nudocs for rich editing, or pulling back edited content. Triggers on "send to nudocs", "upload to nudocs", "edit in nudocs", "pull from nudocs", "get the nudocs link", "show my nudocs documents".
last30days
Research any topic from the last 30 days on Reddit + X + Web, synthesize findings, and write copy-paste-ready prompts. Use when the user wants recent social/web research on a topic, asks "what are people saying about X", or wants to learn current best practices. Requires OPENAI_API_KEY and/or XAI_API_KEY for full Reddit+X access, falls back to web search.
jira
Use when the user mentions Jira issues (e.g., "PROJ-123"), asks about tickets, wants to create/view/update issues, check sprint status, or manage their Jira workflow. Triggers on keywords like "jira", "issue", "ticket", "sprint", "backlog", or issue key patterns.
gsc
Query Google Search Console for SEO data - search queries, top pages, CTR opportunities, URL inspection, and sitemaps. Use when analyzing search performance, finding optimization opportunities, or checking indexing status.