How does the skill calculate technical debt priority?

The skill uses a weighted formula that considers the impact on the system, the 'interest' (cost per sprint if left unfixed), and the severity of the issue relative to the effort required to fix it.

Can this skill be used for legacy code migration?

Yes, it is specifically designed to evaluate legacy codebases, helping teams identify the most critical areas that require modernization before starting a migration.

What categories of technical debt can it identify?

It categorizes debt into six key areas: Code Quality (complexity), Architecture (design), Testing (coverage/flakiness), Documentation, Security (vulnerabilities), and Performance.

Does it provide actionable reports for management?

Absolutely. It generates structured reports including summaries of total effort hours, monthly interest costs, and a prioritized list of top-priority items for easy stakeholder communication.

How does the automated code quality scanner work?

The scanner utilizes static analysis to detect common issues like 'any' types in TypeScript, magic numbers, excessively long functions, and missing documentation or TODOs.

Technical Debt Assessment

Name: Technical Debt Assessment
Author: aj-geddes

byaj-geddes

•

安全与测试

Analyzes, quantifies, and prioritizes codebase technical debt to inform data-driven refactoring and architectural decisions.

The Technical Debt Assessment skill provides a systematic framework for identifying, measuring, and managing technical debt within your software projects. By leveraging automated code analysis, impact metrics, and priority calculations, it helps development teams move beyond subjective arguments for refactoring toward objective, data-driven decisions. Whether you are performing legacy code evaluations, planning sprints, or conducting acquisition due diligence, this skill enables you to quantify the 'interest' paid on sub-optimal code and generates comprehensive reports to justify quality investments to stakeholders.

主要功能

01Categorized debt reporting across architecture, testing, security, and documentation.

02Customizable quality gates to track and manage code health over time.

03Quantitative debt calculation based on severity, effort, and monthly interest.

04ROI-based prioritization logic to identify high-impact refactoring targets.

0518 GitHub stars

06Automated code scanning for anti-patterns, magic numbers, and complex functions.

使用场景

01Conducting deep-dive audits for legacy codebase modernization or due diligence.

02Justifying architectural changes to stakeholders using quantified impact metrics.

03Prioritizing refactoring tasks during sprint planning to maximize developer velocity.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add aj-geddes/useful-ai-prompts technical-debt-assessment

For use in Claude.ai and ChatGPT

Download Skill