Skip to main content
skill CX Codex

tech-debt-tracker · borghei — Claude Code skill: how it works

tech-debt-tracker — a skill for Claude Code and Codex that audits repositories for technical debt and ranks refactoring backlogs. Calculates cost-of-delay metrics to plan capacity for upcoming sprints.

LicenseRef-MIT-Commons-Clause 125 installs ★ 1,183 updated 2026-11-08

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a claude-code
Open on GitHub

What tech-debt-tracker does

The skill bundles three Python utilities: debt_scanner.py spots code issues, debt_prioritizer.py orders tasks using cost-of-delay, WSJF, or RICE, and debt_dashboard.py compares historical project states over quarterly or custom intervals.

Detection groups findings into six buckets covering code, architecture, test suites, documentation, dependencies, and infrastructure. The codebase health metric is computed per 1,000 lines and weights issues from low (0.5) to critical (5).

This utility only catalogues and ranks debt; it does not rewrite files or monitor runtime performance.

What it helps with

  • detect structural code debt across directories via AST and regex
  • score refactoring priority using WSJF or cost-of-delay formulas
  • plan engineering capacity balance between product features and tech debt
  • generate longitudinal debt dashboards for executive reviews

Example prompts for the agent

  • Scan the src/ directory with tech-debt-tracker and output both JSON and text reports
  • Rank our current debt inventory using WSJF for a team size of 8
  • Generate an executive trend summary comparing our last two debt scan snapshots

How to install tech-debt-tracker

1Skills CLI (Vercel)

npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a claude-code

2Manually: put the files in place

~/.claude/skills/tech-debt-tracker/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tech-debt-tracker/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tech-debt-tracker

How to install tech-debt-tracker in Claude Code?

Run npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a claude-code in your terminal. The skill file is placed in ~/.claude/skills/tech-debt-tracker/SKILL.md.

Does tech-debt-tracker modify code automatically?

No, it focuses strictly on discovery, scoring, and capacity forecasting. It leaves actual code refactoring to the developer.

How does the scanner analyze non-Python code?

Python files go through AST parsing. Every other language is scanned using regex pattern heuristics.

Similar skills

All skills for Code review and refactoring →

tech-debt-tracker by other authors comes first.

tech-debt-tracker Alireza Rezvani tech-debt-tracker scans codebases for technical debt, scores items using WSJF or RICE, and tracks trends across snapshots. Built for planning refactoring sprints. CX Codex +1 614installs code-refactoring-tech-debt sickn33 code-refactoring-tech-debt analyzes code and git history to identify technical debt, estimate development drag, and prioritize refactoring tasks with clear trade-offs. CX Codex +1 2installs tech-debt Seth Hobson tech-debt inventories codebase technical debt, calculates velocity loss in developer hours, and drafts a prioritized remediation plan based on expected ROI. CX Codex +1 ★ 42,780repo stars technical-debt-manager davila7 technical-debt-manager scans codebases for architecture flaws and test gaps. Helps build a prioritized refactoring plan for sprint planning. CX Codex 857installs tech-debt-analyzer ailabs-393 tech-debt-analyzer detects technical debt across JavaScript and TypeScript codebases using Python scripts, then structures findings into debt registers and architecture records. CX Codex +1 991installs Technical Debt Remediation Plan official github Generates actionable technical debt remediation plans for code and test suites. It helps teams audit accumulated debt without modifying project files. CX Codex +1 ★ 41,430repo stars remove-technical-debt wondelai remove-technical-debt — a skill for Claude Code and Codex that guides developers through retiring technical debt step by step without a rewrite. Progress and decisions stay documented in the docs/ folder. CX Codex +1 2,600installs

From the same set120

The whole set →
migration-architect migration-architect — a skill for Claude Code plans staged migrations for databases, APIs, services, and infrastructure. It checks schema compatibility and prepares rollback steps before cutover. CX Codex +1 126installs soc2-compliance-expert soc2-compliance-expert manages SOC 2 Type I and Type II readiness against Trust Services Criteria, covering control validation and audit evidence collection. CX Codex +1 126installs saas-scaffolder The saas-scaffolder Claude Code skill lays out a Next.js SaaS starter and guides setup for authentication, billing, and tenant separation. Run it when starting a subscription product or multi-tenant app. CX Codex +1 125installs incident-commander incident-commander — a skill for Claude Code guides production incident response: it scores severity, rebuilds timelines, and drafts postmortems. It also runs on Codex, Cursor, and other platforms. CX Codex +1 125installs pre-mortem pre-mortem — a skill for Claude Code that structures prospective hindsight exercises to anticipate launch disasters. Triggers during release planning, large migrations, or major architectural overhauls. CX Codex +1 124installs agent-workflow-designer The agent-workflow-designer Claude Code skill designs workflows for multiple AI agents and estimates their cost before implementation. It comes into play when planning parallel tasks, delegation, or request routing. CX Codex +1 123installs brainstorm-ideas brainstorm-ideas — a skill for structured product ideation: generates ideas from product, design, and engineering angles, maps each to a market opportunity, and identifies the top five. CX Codex +1 121installs atlassian-admin atlassian-admin — a skill for auditing and planning Atlassian Cloud or Data Center administration: users, permissions, SSO, licenses and system health. CX Codex +1 121installs

Project sponsors

Companies that keep this analytics open