tech-debt-tracker

Scan codebases to categorize and prioritize technical debt items.

Updated May 24, 2026
One-click install
npx skills add https://github.com/haJ1t/senior-dev-squad-skills --skill tech-debt-tracker-haj1t
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-debt-tracker
Source: https://github.com/haJ1t/senior-dev-squad-skills/tree/main/plugins/senior-dev-squad/skills/tech-debt-tracker
Command: npx skills add https://github.com/haJ1t/senior-dev-squad-skills --skill tech-debt-tracker-haj1t

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive approach to identify, categorize, prioritize, and report technical debt in a codebase, ensuring maintainability and strategic addressing of debt items.

Core Features & Use Cases

  • Code Smell Scanning: Identifies TODO/FIXME/HACK/XXX comments and provides context.
  • Duplicate Code Detection: Finds and flags duplicate code blocks.
  • Complexity Analysis: Measures cyclomatic complexity and flags functions exceeding defined thresholds.
  • Dependency Health Audits: Checks for outdated and abandoned packages, and audits for security vulnerabilities.
  • Documentation Gaps: Identifies missing documentation for public APIs and modules.
  • Prioritization and Logging: Categorizes debt items by impact area and assigns priority levels.
  • Use Case: For a developer joining a new project or planning sprint items, this Skill helps to quickly understand and prioritize existing technical debt.

Quick Start

Run the tech-debt-tracker skill on your project directory to automatically scan and categorize technical debt.

Frequently Asked Questions about tech-debt-tracker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scan my codebase for technical debt and TODO comments?

To scan for technical debt, the Skill identifies and categorizes TODO, FIXME, HACK, and XXX comments using regex, providing context to help developers understand and prioritize existing codebase issues.

What is the best way to detect duplicate code and high complexity in my project?

The best way to detect duplicate code and high complexity is using code duplication tools and complexity metrics, which flag functions exceeding defined cyclomatic complexity thresholds for targeted refactoring.

Can I audit outdated dependencies and security vulnerabilities automatically?

Yes, you can audit outdated dependencies automatically. The Skill performs dependency health checks to identify abandoned packages and security vulnerabilities within your software development workflow.

How does this approach identify missing documentation for public APIs?

This approach identifies missing documentation by running documentation checks that scan for undocumented public APIs and modules, categorizing these gaps as technical debt items requiring attention.

Does this technical debt tracker work for any programming language?

The technical debt tracker is suitable for evaluating codebases generally, utilizing regex, dependency auditing, and complexity metrics that apply across software development workflows without specific language constraints.

How do I prioritize technical debt items for my next sprint?

To prioritize technical debt items for a sprint, the Skill categorizes identified issues by impact area and assigns priority levels, generating a report that helps you strategically address debt.