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
npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/tech-debt-tracker/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tech-debt-tracker/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a codex2Manually: put the files in place
.agents/skills/tech-debt-tracker/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a cursor2Manually: put the files in place
.cursor/skills/tech-debt-tracker/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills engineering/tech-debt-tracker/SKILL.md2Manually: put the files in place
.github/skills/tech-debt-tracker/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/tech-debt-trackerManually: put the files in place
.devin/skills/tech-debt-tracker/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.