# Todo Check

> Audit a file for TODO comments, pending work items, or technical debt markers. Useful for checking code readiness before a commit or reviewing task status. Trigger with "check for todos", "audit for debt", "list pending work", or "scan for TODOs".

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

---


## Dependencies

This skill requires **Python 3.8+** and standard library only. No external packages needed.

**To install this skill's dependencies:**
```bash
pip-compile ./requirements.in
pip install -r ./requirements.txt
```

See `./requirements.txt` for the dependency lockfile (currently empty — standard library only).

---

# todo-check

Check for TODOs and debt markers in a file.

## Usage
`python ${CLAUDE_PLUGIN_ROOT}/skills/todo-check/scripts/check_todos.py <path>`

<example>
Context: Directly auditing a specific file.
user: "Are there any todos left in project_logic.py?"
assistant: "I'll run the todo-check audit to find any pending work items in project_logic.py."
</example>

<example>
Context: Scanning for debt as part of a review.
user: "List the pending work items in utils.py before we merge."
assistant: "I'll use the todo-check tool to scan utils.py for any TODO markers or debt."
</example>

<example>
Context: Agent proactively audits before proposing a code change.
assistant: [autonomously, before suggesting a refactor] "Let me run todo-check on this file first to surface any existing debt markers before adding more changes."
<commentary>
Implicit audit trigger -- agent uses todo-check as a pre-flight check, no user prompt needed.
</commentary>
</example>