agentsclimarketplace

Tech debt register

Skill Amey-Thakur/AI-SKILLS/skills/code-quality/tech-debt-register

Plug-and-play skills and prompts for every AI coding agent

Install
npx -y skills add Amey-Thakur/AI-SKILLS --skill tech-debt-register

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 19 days oldThe repository was created 19 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
  • 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Track technical debt deliberately by framing each item as interest owed and budgeting steady paydown. Use when debt is piling up as vague complaints and you need to make it fundable work.

SKILL.md

2.5 KB, as published. Nobody here has run it

Tech debt register

Technical debt is a metaphor with a sharp edge. Like financial debt it carries interest: the recurring drag every future change pays until you settle the principal. Untracked, debt is just a feeling that the code is bad. A register turns it into named items with a cost, so paydown competes for time on evidence instead of vibes.

Method

  1. Log debt as items with a cost, not a mood. Each entry names what is wrong, where, why it hurts, and the estimated fix: "auth checks copied across 6 controllers; a rule change means 6 edits and one miss is a hole." Keep it in the tracker beside features, not a wiki no one opens.
  2. Frame each item by its interest rate. High-interest debt taxes frequent changes in a hot module everyone touches; low-interest debt sits in stable code no one edits. A messy file untouched for two years is debt at near-zero interest.
  3. Prioritize by interest, not principal. Pay down what you keep paying interest on, even when the fix is large, before cheap fixes in cold code. The question is not "how ugly" but "how often does this ugliness cost us."
  4. Budget a standing slice of capacity. Reserve a fixed fraction of each sprint, commonly 15 to 20 percent, for paydown. A named budget beats "when we have time," which never arrives. Track it like any other work.
  5. Attach debt to the features it blocks. When an item slows a roadmap feature, record the link. Debt that gates revenue work gets funded; debt argued on principle alone loses to the next deadline. Make the drag visible to whoever sets priorities.
  6. Prune on a cadence. Quarterly, walk the register: delete items made irrelevant by other changes, and re-cost interest as usage shifts. A register no one prunes becomes a graveyard, and graveyards get ignored.

Signals

  • Can you name the three highest-interest items and say what each one taxes?
  • Did paydown actually get capacity this sprint, or lose to features silently?
  • Would a new hire understand each entry's cost without asking you?

Boundaries

A register organizes deliberate debt; it does not license shipping known-bad code because "it is tracked." Bugs and security holes are defects, not debt: route them through the normal bug flow. Defer prioritization ties to the team's planning process and the product owner.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.