Agent skill · Code Review & Quality

tech-debt-tracker

Scan codebases for technical debt, score severity, track trends, and generate prioritized remediation plans. Use when users mention tech debt, code quality, refactoring priority, debt scoring, cleanup sprints, or code health assessment. Also use for legacy code modernization planning and maintenance cost estimation.

Alireza Rezvani23,369★ · +428/wk · 1 repos on radarProfile →
claude-codecodexcursorships scriptsMIT
Install
npx skills add alirezarezvani/claude-skills --skill tech-debt-tracker --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 18
SKILL.md size: 5 KB
Bundled scripts: yes
Path: engineering/skills/tech-debt-tracker/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 23,791 · +422 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# 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 tool

What's inside
Steps it walks through
  1. Overview
  2. What This Skill Provides
  3. Quick Start — scan → prioritize → dashboard
  4. 1. Scan the codebase
  5. 2. Prioritize the backlog
  6. 3. Track trends over time
  7. Verification loop
  8. Technical Debt Classification Framework
  9. Common Pitfalls and How to Avoid Them
  10. 1. Analysis Paralysis
  11. 2. Perfectionism
  12. 3. Ignoring Business Context
  13. 4. Inconsistent Application
  14. 5. Tool Over-Engineering
Ships with 17 files
  • README.md
  • assets/historical_debt_2024-01-15.json
  • assets/historical_debt_2024-02-01.json
  • assets/sample_codebase/src/frontend.js
  • assets/sample_codebase/src/payment_processor.py
  • assets/sample_codebase/src/user_service.py
  • assets/sample_debt_inventory.json
  • expected_outputs/sample_dashboard_output.json
  • expected_outputs/sample_prioritization_output.json
  • expected_outputs/sample_scan_output.json
  • references/debt-classification-taxonomy.md
  • references/debt-frameworks.md
  • references/prioritization-framework.md
  • references/stakeholder-communication-templates.md
  • scripts/debt_dashboard.py
  • scripts/debt_prioritizer.py
  • scripts/debt_scanner.py
Commands it runs
python3 scripts/debt_scanner.py /path/to/codebase --format json --output debt_inventory.json
python3 scripts/debt_prioritizer.py debt_inventory.json --framework wsjf --team-size 6 --sprint-capacity 20 --format json --output debt_priorities.json
python3 scripts/debt_dashboard.py --input-dir snapshots/ --period monthly --format both --output debt_dashboard
More from claude-skills
All skills →
About this skill
What does the tech-debt-tracker skill do?

Scan codebases for technical debt, score severity, track trends, and generate prioritized remediation plans. Use when users mention tech debt, code quality, refactoring priority, debt scoring, cleanup sprints, or code health assessment. Also use for legacy code modernization planning and maintenance cost estimation.

How do I install it?

Run `npx skills add alirezarezvani/claude-skills --skill tech-debt-tracker --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From alirezarezvani/claude-skills, a repository with 23,791 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going