Tech Debt Tracker

Scan Python codebases to identify, prioritize, and track technical debt.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/mcauduro0/Macro_Trading --skill tech-debt-tracker-mcauduro0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Tech Debt Tracker
Source: https://github.com/mcauduro0/Macro_Trading/tree/main/.claude/skills/alireza-tech-debt-tracker
Command: npx skills add https://github.com/mcauduro0/Macro_Trading --skill tech-debt-tracker-mcauduro0

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires json, argparse, os, re, sys, math, collections, datetime, pathlib, typing, dataclasses, statistics, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill tackles the pervasive issue of technical debt, which slows down development, increases bugs, and hinders maintainability by providing tools to identify, prioritize, and track these issues systematically.

Core Features & Use Cases

  • Automated Debt Detection: Scans codebases to find various types of technical debt like large functions, complexity, and security vulnerabilities.
  • Intelligent Prioritization: Ranks debt items based on business impact and effort using frameworks like Cost of Delay or WSJF.
  • Trend Analysis: Tracks debt evolution over time with dashboards and reports for better decision-making.
  • Use Case: A development team can use the scanner to identify code smells, then the prioritizer to create a backlog of actionable tasks for the next sprint, and finally the dashboard to show management the progress and impact of their debt reduction efforts.

Quick Start

Use the Tech Debt Tracker skill to scan the current directory for 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 identify and track technical debt across my codebase?

You can identify and track technical debt by running automated Python scanning scripts that use AST parsing and regex to detect code smells, large functions, and complexity, then monitor the evolution of these issues over time with trend analysis dashboards.

How do I prioritize refactoring tasks using cost of delay or WSJF frameworks?

You can prioritize refactoring tasks by applying built-in prioritization frameworks like Cost of Delay, WSJF, or RICE, which rank identified technical debt items based on their business impact and development effort to create an actionable backlog.

Can I analyze code quality and complexity automatically using Python?

Yes, you can automatically analyze code quality and complexity by executing Python scripts that perform AST parsing and regex matching to scan directories for security vulnerabilities, large functions, and structural code smells.

What is the best way to track developer velocity and technical debt reduction over time?

The best way to track debt reduction over time is to use dashboarding scripts that perform trend analysis and velocity tracking, generating reports that show management the progress and impact of refactoring efforts across sprints.

Does this technical debt scanner require any external dependencies or tools?

No external tools are required; the scanner relies solely on standard Python libraries included in its dependencies, such as os, re, sys, pathlib, typing, and dataclasses, to perform AST parsing and generate analysis reports.

What types of code smells and technical debt can automated scanning detect?

Automated scanning can detect various types of technical debt, including large functions, high code complexity, and security vulnerabilities, by applying AST parsing and regex pattern matching directly to the source files in the target directory.