engineering-tech-debt

Identify, categorize, and prioritize technical debt with a scoring framework.

Updated May 26, 2026
One-click install
npx skills add https://github.com/avel123111/triplanio --skill engineering-tech-debt-avel123111
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: engineering-tech-debt
Source: https://github.com/avel123111/triplanio/tree/main/.claude/skills/engineering-tech-debt
Command: npx skills add https://github.com/avel123111/triplanio --skill engineering-tech-debt-avel123111

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams accumulate technical debt across code, architecture, tests, dependencies, documentation, and infrastructure, but struggle to decide what to fix first. This Skill provides a structured audit method that turns vague code-quality concerns into a prioritized, business-justified remediation plan. ## Core Features & Use Cases - Debt Categorization: Classifies findings into six types — code, architecture, test, dependency, documentation, and infrastructure debt — each with typical risks. - Prioritization Scoring: Scores each item on Impact, Risk, and Effort, then computes Priority = (Impact + Risk) x (6 - Effort) to rank the backlog objectively. - Phased Remediation Plan: Produces a prioritized list with effort estimates and business justification that fits alongside ongoing feature work. - Use Case: Ask for a technical debt audit of your repository and receive a ranked list of refactoring targets, such as outdated dependencies or missing integration tests, with rationale for each. ## Quick Start Ask the assistant to run a technical debt audit of this codebase and produce a prioritized refactoring plan.

Frequently Asked Questions about engineering-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?

Score each debt item on Impact (1-5), Risk (1-5), and Effort (1-5), then compute Priority = (Impact + Risk) x (6 - Effort). This ranks high-impact, low-effort fixes first and produces a defensible remediation order.

What are the main types of technical debt?

The six categories are code debt, architecture debt, test debt, dependency debt, documentation debt, and infrastructure debt. Each carries distinct risks, from security vulnerabilities in outdated dependencies to regressions from missing test coverage.

How do I justify refactoring work to stakeholders?

Pair each debt item with a business justification tied to its risk, such as security vulnerabilities, scaling limits, or onboarding delays. Presenting a scored, phased plan that runs alongside feature work makes the trade-offs explicit.

When should a team fix tech debt instead of building features?

Address debt when its risk score indicates likely incidents, regressions, or blocked scaling. A phased remediation plan lets teams chip away at high-priority items incrementally without halting feature delivery.

What are the limitations of a tech debt scoring framework?

Scores are subjective estimates, so different reviewers may rate impact and effort differently. The framework guides prioritization but does not replace architectural judgment for large structural decisions.