git:20260420.06c3766 to git:20260427.a7c1e49

---

name: todo-check

description: >

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".

allowed-tools: Bash, Read

---

## 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>