todo-check · diff

git:20260317.204a349 to git:20260319.7d4e3a9

8 added, 0 removed. Audit A to A.

---

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

---

# todo-check

Check for TODOs and debt markers in a file.

## Usage

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

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>

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>