Technical Debt Baselines and Remediation Plans
Build an evidence-backed debt register, compare reliable baselines, and create a prioritized remediation plan with closure checks.
Before & after
Same prompt, same agent — the only difference is the skill.
Technical debt is something that accumulates in codebases over time. There are various things that could be causing issues - old dependencies, poorly structured code, missing tests, things like that. You might want to do a code review to identify areas that need work. Some codebases have more debt than others depending on how long they've been around and how many people worked on them. Prioritizing what to fix is important. Think about what causes the most problems or slows you down the most. Different teams approach cleanup differently.
TECH DEBT SCAN & PRIORITY MATRIX TOP 3 URGENT (fix this sprint): 1. DEPENDENCY SECURITY (score: 94/100 severity) Oldest vulnerable lib: lodash 3.10.1 (2018, 4 critical CVEs) Affected files: 12 imports across utils/ Fix effort: 4hrs (bump to v4.17.21, check deprecated API usage) Blocked by: None Payoff: Unblocks security audit, removes risk of breach 2. TEST COVERAGE CLIFF (score: 78/100) Payment module: 0% coverage (critical path) 15 test cases needed for stripe-integration.ts Fix effort: 8hrs Blocked by: Need Stripe test API keys Payoff: Confidence for next refactor; catches bugs before production 3. CIRCULAR IMPORTS (score: 64/100) models/User.ts ← → services/AuthService.ts Causes tree-shake failures, increases bundle +47KB Fix effort: 6hrs (extract shared enum) Payoff: Smaller JS, faster cold start MODERATE (next quarter): • Deprecated React lifecycle methods in 2 components (score: 42) • Flaky integration tests (score: 38) • Monolithic service class (score: 31) SCORE METHODOLOGY: Severity × Frequency × Fix-effort trade-off REMEDIATION ROADMAP: Start with dependencies (unblock security), then tests (unblock features), then structure (long-term velocity).
About this skill
Your debt backlog keeps growing, but another list of TODOs will not tell you what to fix next or whether last sprint actually helped. This skill turns repository evidence into a prioritized remediation register, then compares subsequent scans without confusing newly discovered debt with newly introduced debt.
What it does
- Scans for consequential duplication, deprecated interfaces, risky test gaps, dependency constraints, and maintenance bottlenecks.
- Ranks findings using demonstrated impact, dependency reach, and recent change frequency, with uncertainty shown explicitly.
- Gives each underlying issue a stable identity so moved files and repeated symptoms do not inflate the backlog.
- Compares baselines using matched scope, history windows, and scoring rules; flags incompatible comparisons.
- Converts priorities into bounded work packages with prerequisites, effort ranges, regression checks, and closure criteria.
- Distinguishes verified fixes, accepted debt, deferred work, and findings that could not be rechecked.
What you get
A scoped debt register and a practical fix-first plan, backed by code locations and observable consequences. For repeat assessments, you also get a baseline comparison that separates new discoveries, verified resolutions, changed exposure, and coverage gaps.
Best for
Engineering leads and maintainers who need to choose cleanup work, justify modernization slices, or track whether debt remediation is producing verified results across releases.
SKILL.md preview
---
name: technical-debt-baselines-and-remediation-plans
description: >-
Scan repository evidence for technical debt, rank findings by impact, blast radius, and change frequency, and create bounded remediation plans. Track stable finding IDs across comparable baselines and require evidence before closing issues. Use when the user says "scan this codebase for technical debt", "what should we refactor first?", "our debt backlog keeps growing", "did the cleanup sprint help?", "compare code health across releases", "plan a legacy modernization", or "estimate the work to fix these hotspots".
---
# Technical Debt Baselines and Remediation Plans
… (sign up to view the full skill)Featured in
More development skills
View all Development skills →Performance Bottleneck Profiling: Node, Python, Go
Classifies a slowdown, gives exact profiler commands, reads the output, and proves the fix with same-conditions p95/p99 numbers.
Feature Scaffolding with Working Tests
Turn a short feature spec into code, runnable tests, and integration wiring that match your existing project.
Feature Flag Rollouts and Kill Switches
Design staged flag rollouts, verify rollback paths, and audit flag debt with explicit defaults, gates, and retirement plans.
Microcontroller Firmware and RTOS Engineering
Build and debug MCU firmware with bounded ISR/RTOS timing, safe DMA ownership, and measured power budgets.