todo-tracker

todo-tracker is a skill for Claude Code, Codex from jdrhyne/agent-skills. It costs 55 tokens per session (1,271 once invoked), scanned A, original, MIT.

A persistent task list stored in a Markdown file, a plain-text document format, rather than in a separate service or database.

In plain words
What is it for?
Add, list, complete, remove, and summarise tasks in a portable TODO file.
Why use it?
It keeps tasks available between sessions and gives them stable IDs, while using safe file updates and recoverable backups.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Add, list, complete, remove, and summarise tasks in a portable TODO file.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/jdrhyne/agent-skills/todo-tracker
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add jdrhyne/agent-skills --skill todo-tracker
Clone the repo
git clone --depth 1 https://github.com/jdrhyne/agent-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for todo-tracker

README.md
[![agentmods](https://agentmods.dev/badge/skills/jdrhyne/agent-skills/todo-tracker/github.svg)](https://agentmods.dev/skills/jdrhyne/agent-skills/todo-tracker)
Your own site
<a href="https://agentmods.dev/skills/jdrhyne/agent-skills/todo-tracker"><img src="https://agentmods.dev/badge/skills/jdrhyne/agent-skills/todo-tracker/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for todo-tracker

Your own site · 80×15
<a href="https://agentmods.dev/skills/jdrhyne/agent-skills/todo-tracker"><img src="https://agentmods.dev/badge/skills/jdrhyne/agent-skills/todo-tracker.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 55 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,271 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00055 $0.01271
Opus 5 $0.00028 $0.00635
Sonnet 5 $0.00011 $0.00254
Haiku 4.5 $0.00006 $0.00127

Measured 10d ago against content hash 8270d796cfcb, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

todo-tracker scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/todo.sh, tests/test_todo.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

clawdbot/todo-tracker/SKILL.md · 118 lines

How it starts

The opening of the file, as written. The whole thing — 118 lines — stays where its author put it; the contents beside it link to each section on GitHub.

TODO Tracker

Maintain a portable Markdown task file without a service or database. Use the bundled script for every operation; do not edit task lines with ad hoc regex commands.

Runtime requirements: Bash and standard awk, cp, chmod, mkdir, mktemp, and mv utilities. Tasks are stored in a user-configurable local Markdown file.

File and Script

  • TODO_FILE selects the task file. Default: TODO.md in the current workspace.
  • Always invoke the bundled script through {baseDir} so execution does not depend on the current directory.
  • Read operations do not create a file.
  • Writes use an adjacent lock, atomic same-directory renames, mode 600, and a recoverable previous-state backup at ${TODO_FILE}.bak.
  • ${TODO_FILE}.next-id is an adjacent mode-600 monotonic ID counter. Keep it with the task file when moving or restoring the tracker; backup rotation must not replace or delete it.
TODO_FILE="$PWD/TODO.md" bash "{baseDir}/scripts/todo.sh" list

Do not use a machine-specific path. Quote TODO_FILE, IDs, and item text.

Stable Identity

New tasks receive monotonic IDs such as T000001. Task text is matched literally and exactly, never as a regex or substring.

  • Under the same writer lock, the script bootstraps the counter from the current task file, ${TODO_FILE}.bak, and any valid existing counter. It reserves and atomically persists the next counter value before publishing a task-file mutation, so a crash may create an ID gap but cannot reuse an ID.
  • Only the structured ID field immediately after a task checkbox participates in counter bootstrapping. ID-looking text inside a task title remains literal task content and never advances the counter.
  • A missing counter is created safely on the next write. A corrupt, symbolic-link, non-regular, or non-0600 counter fails closed; do not delete or reset it to bypass the check.
  • Prefer an ID for done and always use an ID for approved removal.
  • An exact-text target must match one task only.
  • Duplicate open task text is rejected.
  • An ambiguous exact-text target is rejected and the script reports the matching IDs.
  • On the first operation that must resolve or mutate a legacy file, task lines without IDs are assigned deterministic IDs under the writer lock and the migration is persisted atomically; the original remains in the backup. A removal preview can trigger this recoverable metadata migration even though it removes no task.

Read the full file on GitHub · 118 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 118 lines · 55 tokens per session scan A 8270d796cfcb

Subscribe to this mod's changes

todo-tracker is a skill published in the GitHub repository jdrhyne/agent-skills (241 stars, last pushed 10d ago), licensed MIT. It adds 55 tokens to every session and 1,271 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

prd

A guide for writing a PRD, or Product Requirements Document, which explains what a product or feature should achieve and who it is for. It covers goals, users, success measures, limits, prior work, and excluded scope.

Insajin/autopus-adk · 11 tokens

product-discovery

Product discovery workflow with OST, assumption testing, and interview scripts.

Insajin/autopus-adk · 16 tokens

team-coordination

Inspired by the Disp8chTeam multi-agent coordination framework — enables you to organize AI agents into collaborative crews with workspace isolation, P2P messaging, and dependency-aware task management.

aaronnat23/disp8ch · 0 tokens

planner

Interactive planning and execution for complex tasks. Use when breaking down multi-step projects (planning) or executing approved plans through delegation (execution). Planning creates milestones with specifications; execution delegates to specialized agents. Use when you say "plan this feature", "create…

rjmurillo/ai-agents · 60 tokens

execution-plans

Manage execution plans as versioned artifacts with progress tracking and decision logs. Use when you say "create execution plan", "update plan progress", "log decision", "complete plan", or "abandon plan". Do NOT use to break work into milestones or delegate tasks (use planner).

rjmurillo/ai-agents · 61 tokens

openakita/skills@github-automation

Automate GitHub repositories, issues, pull requests, branches, CI/CD, and permissions via Rube MCP (Composio). Manage code workflows, review PRs, search code, and handle deployments programmatically.

openakita/openakita · 53 tokens