todo-check git:20260319.7d4e3a9A

Immutable. This exact content is served forever at /api/v1/blob/72126a3468fcd9bd.

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

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