This breaks down technical debt into six categories (code, architecture, test, dependency, documentation, and infrastructure) and scores each item using a formula that weighs impact, risk, and effort. The output is a prioritized backlog with business justifications and a phased remediation plan you can work through alongside feature development. It's most useful when you know something's wrong but can't articulate why refactoring X matters more than refactoring Y, or when you need to make the case to leadership that yes, we really do need to upgrade that ancient library. The scoring framework is simple enough to be practical without turning debt management into its own full-time job.

skills.sh installs
6.7K
GitHub stars
35.3K
last updated
Aug 21, 2026

Install

$ npx -y skills add anthropics/knowledge-work-plugins --skill tech-debt --agent claude-code

Installs into .claude/skills of the current project.

Files

Tech Debt Management

Systematically identify, categorize, and prioritize technical debt.

Categories

TypeExamplesRisk
Code debtDuplicated logic, poor abstractions, magic numbersBugs, slow development
Architecture debtMonolith that should be split, wrong data storeScaling limits
Test debtLow coverage, flaky tests, missing integration testsRegressions ship
Dependency debtOutdated libraries, unmaintained dependenciesSecurity vulns
Documentation debtMissing runbooks, outdated READMEs, tribal knowledgeOnboarding pain
Infrastructure debtManual deploys, no monitoring, no IaCIncidents, slow recovery

Prioritization Framework

Score each item on:

  • Impact: How much does it slow the team down? (1-5)
  • Risk: What happens if we don't fix it? (1-5)
  • Effort: How hard is the fix? (1-5, inverted — lower effort = higher priority)

Priority = (Impact + Risk) x (6 - Effort)

Output

Produce a prioritized list with estimated effort, business justification for each item, and a phased remediation plan that can be done alongside feature work.

Sponsors

Details

Repository
github.com/anthropics/knowledge-work-plugins
Category
Code Review & Quality
First seen
Apr 16, 2026

More from anthropics/knowledge-work-plugins

All 198
1wondelai avatarsoftware-design-philosophywondelai/skillsManage software complexity through deep modules, information hiding, and strategic programming. Use when the user mentions "module design", "API too complex", "6.4Kskills.sh installs
2calm-north avatarauditcalm-north/seojuice-skillsRun a comprehensive SEO audit on a website covering technical health, on-page optimization, content quality, and backlink profile. Use when the user asks for an6.4Kskills.sh installs
3affaan-m avatarprompt-optimizeraffaan-m/eccAnalyze raw prompts, identify intent and gaps, match ECC components (skills/commands/agents/hooks), and output a ready-to-paste optimized prompt. Advisory role 6.3Kskills.sh installs
4composiohq avataryoutube-downloadercomposiohq/awesome-claude-skillsDownload YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports vari6.3Kskills.sh installs
5wondelai avatarpragmatic-programmerwondelai/skillsApply meta-principles of software craftsmanship: DRY, orthogonality, tracer bullets, and design by contract. Use when the user mentions "best practices", "pragm6.1Kskills.sh installs
6forcedotcom avatardesign-systems-slds-validateforcedotcom/sf-skillsAudit Lightning Web Components for SLDS compliance and produce a scored quality report. Runs the SLDS linter, analyzes CSS for theming hook usage and pairing, c6Kskills.sh installs