Agent skill · software engineering · alirezarezvani
tech-debt-tracker
Find, rank and track tech debt in a codebase. Use whenever the user asks what to refactor first, plans a cleanup sprint, modernizes legacy code or wants to know how messy the code is.
Why this skill is useful
Adds 3 executable scripts for scanning, prioritizing, and tracking technical debt that aren't available in public documentation.
What it needs
Requires python3 installed locally. About 2k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
Tech Debt Tracker Tier: POWERFUL 🔥 Category: Engineering Process Automation Expertise: Code Quality, Technical Debt Management, Software Engineering Overview Tech debt is one of the most insidious challenges in software development - it compounds over time, slowing down development velocity, increasing maintenance costs, and reducing code quality. This skill provides a comprehensive framework for identifying, analyzing, prioritizing, and tracking technical debt across codebases. Tech debt isn't just about messy code - it encompasses architectural shortcuts, missing tests, outdated dependencies, documentation gaps, and infrastructure compromises. Like financial debt, it accrues "interest" through increased development time, higher bug rates, and reduced team velocity. What This Skill Provides This skill offers three interconnected tools that form a complete tech debt management system: 1. Debt Scanner - Automatically identifies tech debt signals in your codebase 2. Debt Prioritizer - Analyzes and prioritizes debt items using cost-of-delay frameworks 3. Debt Dashboard - Tracks debt trends over time and provides executive reporting Together, these tools enable engineering teams to make data-driven decisions about tech debt, balancing new feature development with maintenance work. Quick Start — scan → prioritize → dashboard All paths relative to this skill folder. The scanner's JSON output feeds the prioritizer directly; dated inventory snapshots feed the dashboard. 1. Scan the codebase Emits debtinventory.json with scanmetadata, summary, debtitems[], filestatistics, and recommendations. Report the summary counts to the user. (Dry run: assets/samplecodebase.) 2. Prioritize the backlog Frameworks: costofdelay (default), wsjf, rice. Output contains prioritizedbacklog (work top-down), sprintallocation (paste into sprint planning), and insights. 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/tech-debt-tracker--73c932