Description
Tech-debt is an agent skill that identifies, categorizes and prioritizes technical debt in a codebase or system. It sorts debt into several categories, each with examples and the risk it carries. Code debt includes duplicated logic, poor abstractions and magic numbers, and its risk is bugs and slow development. Architecture debt, such as a monolith that should be split or the wrong data store, leads to scaling limits. Test debt, meaning low coverage, flaky tests and missing integration tests, means regressions ship. Dependency debt covers outdated or unmaintained libraries and carries security risk. Documentation debt, such as missing runbooks and outdated READMEs, creates onboarding pain, and infrastructure debt, such as manual deploys and missing monitoring, adds operational risk. The skill then prioritizes the items using a framework, so the team knows what to refactor first. You trigger it with phrases such as tech debt, technical debt audit, what should we refactor or code health.…
Highlights
- Categories for code, architecture, test, dependency, documentation and infrastructure debt
- Lists the risk each type of debt carries
- Prioritizes items with a framework
- Triggers on phrases such as what should we refactor
Ratings & Reviews
No ratings yet
Be the first to rate tech-debt.
People also visit
tech-debt FAQ
What types of technical debt does it cover?
Code, architecture, test, dependency, documentation and infrastructure debt, each with examples and its risk.
How does it decide what to fix first?
It applies a prioritization framework to the debt it finds, so the most risky items come first.
Who is it for?
Engineering leads and developers who want a structured view of what to refactor.
How do I use it?
Ask for a tech debt audit or say what should we refactor, and point it at the code or system.
How do I install it?
Run npx skills add https://github.com/anthropics/knowledge-work-plugins --skill tech-debt in your terminal.
Is it free?
Yes. The skill is listed as free on skills.sh.
What security audits has it passed?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Pass.
What are the best tech-debt alternatives?
Popular alternatives to tech-debt include request-refactor-plan, blueprint and hexagonal-architecture. See all tech-debt alternatives