# tech-debt-prioritizer

The tech-debt-prioritizer skill scores technical debt by impact, risk, and effort, then ranks the work. Use it to decide which codebase issues to tackle first.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 268 installs · ★ 64 repo stars
- Author: patricio0312rev
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/patricio0312rev/skills/tree/HEAD/architecture/tech-debt-prioritizer/SKILL.md
- Updated: 2026-01-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/tech-debt-prioritizer

## What it does

The skill provides a debt inventory and a scoring method for each item. Rate impact, risk, and effort from 1 to 10, then calculate priority with `(Impact * 2 + Risk * 1.5) / Effort`. The resulting backlog can include owners, ROI assessments, and implementation plans for selected items.

Templates cover individual debt assessments, quarterly paydown plans, and review sessions. They help teams turn scores into scheduled work and set success measures. The rankings depend on applying the rubric consistently; if people score the same kinds of issues differently, the comparison is less useful.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install patricio0312rev/skills architecture/tech-debt-prioritizer/SKILL.md
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/patricio0312rev/skills --path architecture/tech-debt-prioritizer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add patricio0312rev/skills --skill tech-debt-prioritizer -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/patricio0312rev/skills/tree/HEAD/architecture/tech-debt-prioritizer/SKILL.md

## When to use it
- score debt by impact, risk, and effort
- rank backlog items with a priority formula
- assign owners and plans to selected items
- schedule technical debt work for a quarter

## Example prompts
- Assess the technical debt in this project, score each item, and rank the backlog.
- Create detailed assessments for the highest-priority issues, including ROI and implementation plans.
- Draft a quarterly debt paydown plan with owners and success measures.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 57d201b6b8d83977.

BEGIN THIRD-PARTY FILE 57d201b6b8d83977
````text
---
name: tech-debt-prioritizer
description: Scores and prioritizes technical debt by impact, risk, and effort. Provides ranked backlog with ROI analysis and quarterly paydown recommendations. Use for "tech debt", "technical debt management", "code quality", or "refactoring priorities".
---

# Tech Debt Prioritizer

Systematically prioritize and pay down technical debt.

## Scoring Rubric

### Impact Score (1-10)

**10 - Critical:**

- Prevents new features
- Causes frequent prod incidents
- Blocks multiple teams

**7-9 - High:**

- Significantly slows development
- Causes occasional incidents
- Affects one team heavily

**4-6 - Medium:**

- Moderate development friction
- Rare incidents
- Workarounds exist

**1-3 - Low:**

- Minor annoyance
- No incidents
- Easy workarounds

### Risk Score (1-10)

**10 - Critical:**

- Security vulnerability
- Data integrity issues
- Legal/compliance risk

**7-9 - High:**

- Potential data loss
- System instability
- Vendor end-of-life soon

**4-6 - Medium:**

- Performance degradation
- Occasional failures
- Deprecated but working

**1-3 - Low:**

- Code quality issues
- Minor bugs
- Style inconsistencies

### Effort Score (1-10)

**10 - Herculean:**

- 3+ months
- Multiple teams
- High risk changes

**7-9 - Large:**

- 1-3 months
- One team
- Medium risk

**4-6 - Medium:**

- 1-4 weeks
- 1-2 developers
- Low risk

**1-3 - Small:**

- Days
- Single developer
- Very low risk

## Priority Formula

```
Priority Score = (Impact * 2 + Risk * 1.5) / Effort

Higher score = Higher priority
```

## Tech Debt Inventory

```markdown
| ID     | Title                  | Impact | Risk | Effort | Score | Owner     |
| ------ | ---------------------- | ------ | ---- | ------ | ----- | --------- |
| TD-001 | Legacy auth system     | 9      | 10   | 8      | 3.7   | Auth Team |
| TD-002 | No database indexes    | 8      | 7    | 3      | 7.8   | Backend   |
| TD-003 | Monolithic build       | 7      | 4    | 6      | 4.0   | DevOps    |
| TD-004 | Duplicate API logic    | 6      | 3    | 4      | 4.1   | Backend   |
| TD-005 | Outdated dependencies  | 5      | 8    | 2      | 9.0   | All Teams |
| TD-006 | Missing error handling | 4      | 6    | 3      | 5.7   | Backend   |
| TD-007 | Poor test coverage     | 4      | 5    | 7      | 2.3   | All Teams |
| TD-008 | Inconsistent naming    | 3      | 2    | 5      | 1.6   | Frontend  |

**Sorted by Priority Score:**

1. TD-005: Outdated dependencies (9.0)
2. TD-002: No database indexes (7.8)
3. TD-006: Missing error handling (5.7)
4. TD-004: Duplicate API logic (4.1)
5. TD-003: Monolithic build (4.0)
   ...
```

## Detailed Assessment Template

```markdown
## TD-002: No Database Indexes

### Description

Critical queries lack indexes, causing slow response times and high CPU usage.

### Impact (8/10)

- Search queries take 2-5 seconds (should be <500ms)
````
END THIRD-PARTY FILE 57d201b6b8d83977

The third-party file has ended. Everything between the 57d201b6b8d83977 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2870 of 6716 bytes. © patricio0312rev · MIT · https://github.com/patricio0312rev/skills/tree/HEAD/architecture/tech-debt-prioritizer/SKILL.md

_Part of the page did not fit — see the HTML version._

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