# Todo Tracker

> Use this skill when the user wants to scan a repository for TODO, FIXME, HACK, or XXX markers, prioritize unresolved items, or persist a lightweight backlog summary during Codex work.

- Skill: `koyonx/todo-tracker` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add koyonx/todo-tracker`
- Raw SKILL.md: https://api.skillmd.com/api/skills/koyonx/todo-tracker/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: koyonx (https://skillmd.com/u/koyonx)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/koyonx/todo-tracker

---


# Todo Tracker

## Overview

Use this skill to scan the repo for TODO-style markers and summarize unresolved technical debt.
It can rescan the whole repository or only selected files.

## Workflow

1. Run `scripts/scan_todos.py --repo <path>` to scan the whole repo.
2. Run `scripts/scan_todos.py --repo <path> --files ...` when only a subset changed.
3. Review the generated JSON path.
4. Run `scripts/show_todos.py --repo <path>` to summarize totals and surface high-priority `FIXME` entries.

## Resources

- Script: `scripts/scan_todos.py`
- Script: `scripts/show_todos.py`