Tech Debt Paydown

Identify, prioritize, and pay down technical debt without turning every session into a rewrite.

AI Agents / Developmentai-agentsdevelopment
by AgentVoltv1.0.0Published 1y ago1 install
Free to sign up · every skill included with AgentVolt Pro

Before & after

Same prompt, same agent — the only difference is the skill.

PromptOur codebase is full of tech debt. Where do we even start?
Beforegeneric AI agent
Tackling tech debt can feel overwhelming. Here's a general approach:

- Inventory the debt — list the problem areas
- Prioritize by impact and effort
- Focus on debt that slows you down most
- Fix incrementally alongside feature work
- Prevent new debt with better practices

It helps to distinguish debt that actively hurts you from debt that's just ugly but harmless. Focus your energy on the former.

Would you like help creating a plan?
Afterwith Tech Debt Paydown
Tech debt, worked as a repeatable pass instead of a vibe. "The whole
codebase" is not actionable; this makes it a ranked, sized list.

STEP 1 — INVENTORY, BY TYPE (not one bucket)
  ROT      — dead code, unused deps, stale config
  FRICTION — the files everyone dreads touching (ask the team; they know)
  RISK     — no tests on critical paths, security shortcuts
  DESIGN   — the abstraction that fights every new feature

STEP 2 — SCORE EACH: PAIN x FREQUENCY
The key move. A gnarly module nobody touches is low priority; a
mildly-annoying one edited weekly is high. Debt cost = how bad x how
often you hit it. This ranking is what stops you from gold-plating a
dead corner while the daily-friction file festers.

STEP 3 — SEPARATE "HURTS" FROM "UGLY"
Ugly-but-stable code that's rarely touched: leave it. Debt only counts
if it's slowing you down or risking an incident. Half of most "tech
debt" is just aesthetic and safe to ignore.

STEP 4 — THE PLAN
  Top 3 by score → scheduled, sized, owned.
  The rest → a "boy scout" rule (fix debt in files you're already
  editing), so it drains without a dedicated project.

STEP 5 — STOP THE BLEEDING
One prevention change (a lint rule, a review gate) so the same debt
class doesn't refill behind you.

WHAT NOT TO DO
A three-month "pay down all debt" project. It stops feature work, and
the low-frequency items you'd fix weren't costing anything. Rank, fix
the top 3, boy-scout the rest.

Point me at the repo or name the files people dread, and I'll build the
ranked list.

About this skill


name: tech-debt description: Use when Structured Claude skill that gives Claude a repeatable workflow for tech debt.

Tech Debt

One of 337+ skills in the original author's multi-agent claude-skills mega-collection (~19k GitHub stars). Packages the Tech Debt workflow with its own instructions and validation so outputs stay consistent.

What you get

  • Public GitHub repo (alirezarezvani/claude-skills)
  • the tech-debt skill folder with SKILL.md. Part of a 337-skill / 30-agent / 70-command install.

Customize your output

  • Fork the repo and adapt the skill's instructions and references to your workflow.

Example output

Activates automatically when your request matches Tech Debt; chains with the other skills, agents, and commands in the collection.

Best for

Creators, builders, and teams using Claude Code.

SKILL.md preview

SKILL.md
---
name: tech-debt
description: Use when a codebase needs a prioritized technical debt inventory, or before starting new work in an area known to be fragile.
version: 1.0.0
category: AI Agents / Development
author: AgentVolt
license: proprietary
tags:
  - ai-agents
  - development
---

# Tech Debt

Gives Claude a repeatable workflow for identifying, prioritizing, and paying down technical debt in a codebase without turning every session into an open-ended refactor.

## When to use

… (sign up to view the full skill)
Sign up to view, copy, and install the full skill

More ai & agents skills

View all AI & Agents skills →