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.