tech-debt-reducer

Assess and reduce technical debt in TypeScript/Node.js codebases.

1|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/g97iulio1609/vscode-agent-skills --skill tech-debt-reducer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-debt-reducer
Source: https://github.com/g97iulio1609/vscode-agent-skills/tree/main/skills/tech-debt-reducer
Command: npx skills add https://github.com/g97iulio1609/vscode-agent-skills --skill tech-debt-reducer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a systematic approach to identify, prioritize, and eliminate technical debt, improving maintainability, performance, and health metrics across a codebase.

Core Features & Use Cases

  • Complexity Assessment: Measure function complexity, code heft, and maintainability.
  • Dead Code & Smell Detection: Identify unused code, long functions, and anti-patterns.
  • Debt Reporting & Prioritization: Generate a prioritized backlog of debt items and refactor patterns.
  • Examples: Apply to a legacy TypeScript project to produce a debt backlog and a targeted refactor plan aligned with risk and impact.

Quick Start

Run the quick-start steps to analyze a repository: start with scripts/analyze-complexity.ts and review the generated debt report.

Frequently Asked Questions about tech-debt-reducer

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

FAQPage Schema
How do I identify and eliminate technical debt in a TypeScript codebase?

Technical debt reduction systematically identifies complexity, unused code, and anti-patterns, then prioritizes refactoring by risk and impact. This Skill analyzes TypeScript/Node.js repositories using complexity assessment, dead code detection, and smell analysis to generate a prioritized backlog and refactor plan.

What's the best way to measure code complexity and maintainability?

Complexity assessment measures function complexity, code heft, and maintainability indices across your codebase. The Skill runs analysis scripts on Node.js 18+ to produce metrics that guide refactoring priorities and track improvement over time.

How do I find unused code and code smells in a legacy TypeScript project?

Dead code and smell detection identifies unused functions, long methods, and anti-patterns automatically. Scripts scan multi-file repositories and flag problematic patterns so you can eliminate clutter and modernize legacy code safely.

Can I use this approach on large, multi-file repositories?

Yes, this Skill applies across multi-file TypeScript/Node.js repositories of any scale. It handles dependency updates, architecture improvements, and performance optimization through a phased workflow of assessment, categorization, and prioritization.

What do I need to run the technical debt analysis?

You need Node.js 18+, a TypeScript/Node.js codebase, and optionally ESLint and Prettier. The Skill provides analysis scripts and generates a debt report and prioritized backlog as outputs for actionable refactoring guidance.

How does this differ from simply running a linter on code?

While linters catch style issues, technical debt reduction performs deeper analysis: measuring cyclomatic complexity, finding dead code, detecting architectural smells, and prioritizing refactoring by business impact. It produces a holistic debt backlog, not just lint violations.