What problem does it solve?
Technical debt accumulates unnoticed in codebases, leading to maintainability issues, hidden bugs, and reduced development velocity. This skill helps teams systematically detect, record, and prioritize that debt.
Core Features & Use Cases
- Scanning: Automatically searches the repository for common debt markers such as TODO, FIXME, HACK, deprecated APIs, large files, and duplicated code, categorizing findings into architecture, quality, test, documentation, dependency, and performance debt.
- Register Management: Maintains a markdown debt register (
docs/tech-debt-register.md) where new entries can be added manually or updated after prioritization.
- Prioritization: Calculates priority scores based on impact, frequency, and effort, reorders the register, and recommends items for the next sprint.
- Reporting: Generates summary statistics and trends to keep stakeholders informed about debt health.
Quick Start
Ask the tech-debt skill to scan the codebase and update the debt register.