Skip to content

skilldrop·docs·How-to

Use tech-debt-register

Turn a pile of technical-debt complaints, TODOs and incident notes into a ranked register

Turn a pile of technical-debt complaints, TODOs and incident notes into a ranked register: each item with where it lives, the cost it imposes today backed by evidence, the size of the fix, a decision (pay now, schedule, accept or watch) with the trigger that reopens it, and an owner if one was given. It ends with the few items worth paying down this quarter and why.

Reach for it when the user asks for a tech debt register, a debt inventory or backlog, "what debt should we pay down", "prioritise our tech debt", or wants to make the case for refactoring time.

Install it

npx skilldrop-cli install tech-debt-register                 # Claude Code, your user folder
npx skilldrop-cli install tech-debt-register --project       # Claude Code, this repo
npx skilldrop-cli install tech-debt-register --ide cursor    # or kiro, codex, antigravity, copilot

It is part of the Dev team pack: --pack dev-team installs it with its neighbours.

Ask for it

Say it the way you would to a colleague. Requests like these route to it:

Requests like these belong to a different skill, so it shouldn't answer them:

If another skill answers instead, ask for this one by name: "use tech-debt-register".

Check what you get

A good result:

Use something else when

Next

Edit this page on GitHub · View source