What it does

The Tech Debt Scanner is a diagnostic tool designed for developers and engineering leads who need a quantitative look at codebase rot. It programmatically audits your repository across five vectors: comment legacy (TODOs/FIXMEs), structural complexity (deep nesting/long methods), dependency staleness, test coverage gaps, and documentation voids.

Why use this skill

Manually hunting for tech debt is tedious and often subjective. This skill automates the discovery process using standardized heuristics, providing a neutral "second opinion" on code quality. It's significantly more effective than manual prompting because it uses structured shell scripts and regular expression patterns to parse thousands of files in seconds, categorizing findings by severity from Critical to Low.

Supported tools

• Languages: Support for 15+ languages including TypeScript, Python, Go, Rust, and Java.
• Environments: Works in any Unix-like environment using standard tools (grep, find, awk).
• Workflow: Generates clean Markdown reports ready to be converted into Jira tickets or GitHub issues.

The Output

You receive a structured Markdown report that catalogs every indicator of debt, its location, and actionable remediation steps. It specifically highlights "Critical" items—like disabled security checks or CVE-prone dependencies—that require immediate attention before your next release.