technical-debt-visualizer

Aggregate complexity, test coverage gaps, and change frequency to identify high-risk code hotspots.

2|1|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/jorgealves/agent_skills --skill technical-debt-visualizer
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: technical-debt-visualizer
Source: https://github.com/jorgealves/agent_skills/tree/main/technical-debt-visualizer
Command: npx skills add https://github.com/jorgealves/agent_skills --skill technical-debt-visualizer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Technical Debt Visualizer helps engineering teams identify files and modules with high complexity, lack of tests, and frequent changes, enabling targeted refactoring and sprint planning.

Core Features & Use Cases

  • Heat-map and metrics report: Visualizes complexity, test coverage, and change frequency to highlight hotspots.
  • Prioritized refactoring targets: Suggests files that maximize impact when reduced debt.
  • Due diligence and architectural reviews: Assists architects in assessing health of a codebase before acquisitions or major changes.

Quick Start

Use the Technical Debt Visualizer to scan a repository and generate a report showing hotspots and recommended refactors.

Frequently Asked Questions about technical-debt-visualizer

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

FAQPage Schema
How do I identify technical debt hotspots in my codebase for refactoring?โ–ผ

To identify technical debt hotspots, aggregate code complexity, test coverage gaps, and git change frequency to visualize high-risk files. This generates a heatmap report highlighting modules that need targeted refactoring during sprint planning.

What metrics indicate high-risk technical debt in a repository?โ–ผ

High-risk technical debt is indicated by aggregating code complexity, test coverage gaps, and change frequency. Files with high complexity, lacking tests, and frequently modified in git history represent the most critical hotspots requiring immediate refactoring.

Can I analyze code complexity and git history without executing the codebase?โ–ผ

Yes, you can analyze code complexity and git history without executing code by performing static analysis of code structure and historical data. This approach safely evaluates codebase health for architectural reviews and due diligence.

How do I prioritize refactoring targets during sprint planning?โ–ผ

Prioritize refactoring targets by scanning the repository for files that maximize impact when debt is reduced. The analysis suggests specific files based on aggregated complexity and change frequency metrics to guide sprint planning.

What is the best way to assess codebase health before an acquisition?โ–ผ

The best way to assess codebase health before an acquisition is running static analysis to evaluate complexity, test coverage, and git change frequency. This due diligence process highlights architectural risks and high-interest technical debt hotspots.

Does technical debt analysis work for architectural reviews across multiple repositories?โ–ผ

Yes, technical debt analysis works for architectural reviews across repositories by aggregating complexity and change frequency metrics. It evaluates structural health and coverage gaps without executing code, making it suitable for large-scale architectural assessments.