Tech Debt Paydown
Identify, prioritize, and pay down technical debt without turning every session into a rewrite.
Before & after
Same prompt, same agent — the only difference is the skill.
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?
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
---
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)More ai & agents skills
View all AI & Agents skills →Skill Status Report
Scan every skill in a project and report which pass validation, which are stale, and which lack required metadata.
Skills Scaffolder
Scaffold a new skills directory — folder structure, metadata, a baseline validation pass — with the right conventions from day one.
Research Bundle
Run a multi-step research task as one pipeline: gather sources, extract findings, validate consistency, emit one structured bundle.
Workspace Admin
Administer a Cowork or Claude workspace — settings, access, configuration — with every change scoped and verified.