tech-debt

Categorize technical debt and score impact, risk, and effort for remediation planning.

2|1|Updated May 17, 2026
One-click install
npx skills add https://github.com/rakibulism/agent-skills-os --skill tech-debt-rakibulism
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-debt
Source: https://github.com/rakibulism/agent-skills-os/tree/main/skills/engineering-tech-debt
Command: npx skills add https://github.com/rakibulism/agent-skills-os --skill tech-debt-rakibulism

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams make sense of accumulated code, architecture, test, dependency, documentation, and infrastructure debt so they can improve code health without guessing what to fix first.

Core Features & Use Cases

  • Debt classification: Separates technical debt into clear categories such as code, architecture, test, dependency, documentation, and infrastructure debt.
  • Priority scoring: Ranks each item using impact, risk, and effort so remediation work is focused on the highest-value fixes.
  • Phased remediation planning: Produces a practical backlog and sequence of improvements that can be completed alongside feature work.
  • Use case: A team preparing for a release can ask for a technical debt audit and get a ranked list of refactors, test gaps, and operational improvements to address over time.

Quick Start

Ask the tech-debt skill to audit the current codebase, categorize the main sources of technical debt, and return a prioritized refactoring backlog with effort estimates.

Frequently Asked Questions about tech-debt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prioritize technical debt in my codebase for refactoring?

Prioritize technical debt by categorizing items into code, architecture, and infrastructure buckets, then scoring each by impact, risk, and effort. This produces a ranked remediation backlog focused on the highest-value fixes to execute alongside feature work.

What is the best way to plan maintenance backlog items alongside feature work?

The best way to plan a maintenance backlog is using phased remediation planning. By categorizing debt sources and applying impact-risk-effort scoring, you generate a practical sequence of improvements that integrates directly into your regular development cycle.

How do I categorize technical debt during a code health review?

Categorize technical debt during a code health review by separating accumulated issues into distinct groups: code, architecture, test, dependency, documentation, and infrastructure debt. This classification clarifies exactly what needs fixing before applying priority scoring.

Can I evaluate engineering tradeoffs for refactoring based on risk and effort?

Yes, you can evaluate engineering tradeoffs by applying impact-risk-effort scoring to each refactoring decision. This method quantifies the operational risk of leaving debt unresolved against the development effort required for remediation.

What categories of technical debt should I audit before a software release?

Before a software release, audit code, architecture, test, dependency, documentation, and infrastructure debt. Identifying these main sources ensures your release preparation addresses both code health gaps and operational improvement requirements.