# tech-debt-tracker

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 125 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/tech-debt-tracker/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-tech-debt-tracker

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/tech-debt-tracker/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tech-debt-tracker/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tech-debt-tracker/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tech-debt-tracker/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/tech-debt-tracker/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/tech-debt-tracker/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/tech-debt-tracker
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tech-debt-tracker/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill tech-debt-tracker -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/tech-debt-tracker/SKILL.md

## When to use it
- 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
- 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

## Similar
- [code-refactoring-tech-debt](https://affpapa.org/en/nevibecode/skills/code-refactoring-tech-debt.md) — skill · 2 installs
- [tech-debt](https://affpapa.org/en/nevibecode/commands/tech-debt.md) — command · ★ 42780 repo stars
- [technical-debt-manager](https://affpapa.org/en/nevibecode/agents/technical-debt-manager.md) — subagent · 857 installs
- [tech-debt-analyzer](https://affpapa.org/en/nevibecode/skills/tech-debt-analyzer.md) — skill · 991 installs
- [Technical Debt Remediation Plan](https://affpapa.org/en/nevibecode/agents/technical-debt-remediation-plan.md) — subagent · ★ 41430 repo stars
- [remove-technical-debt](https://affpapa.org/en/nevibecode/skills/remove-technical-debt.md) — skill · 2600 installs

## Other versions with the same name
- [tech-debt-tracker · alirezarezvani](https://affpapa.org/en/nevibecode/skills/tech-debt-tracker.md) — 614 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
