techdebt

Scan codebases for technical debt and generate a prioritized cleanup plan.

Updated Jun 12, 2025
One-click install
npx skills add https://github.com/alirezamohammadpoor/zone2run --skill techdebt-alirezamohammadpoor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: techdebt
Source: https://github.com/alirezamohammadpoor/zone2run/tree/main/.agents/skills/techdebt
Command: npx skills add https://github.com/alirezamohammadpoor/zone2run --skill techdebt-alirezamohammadpoor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill proactively scans codebases for technical debt, including duplication, dead code, type safety issues, and performance anti-patterns, to improve overall code quality and maintainability.

Core Features & Use Cases

  • Duplication Detection: Identifies repeated code blocks and suggests extraction.
  • Dead Code Removal: Finds and flags unused imports, exports, and files.
  • Type Safety Analysis: Detects issues like any types and missing annotations.
  • Use Case: After a development sprint, run this Skill to get a report on areas needing refactoring, ensuring the codebase remains clean and efficient.

Quick Start

Scan the current project for technical debt and provide a prioritized action plan.

Frequently Asked Questions about techdebt

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

FAQPage Schema
How do I scan my codebase for technical debt and get a refactoring plan?

Scanning for technical debt involves analyzing code structure to detect duplication, dead code, and type safety issues. The tool then provides a prioritized action plan with actionable cleanup recommendations to improve maintainability.

What is the best way to find dead code and unused imports in my project?

To find dead code, the scanner flags unused imports, exports, and files by analyzing your codebase structure. It identifies these unused elements and suggests removal to keep the project clean and efficient.

How does code duplication detection work for refactoring?

Code duplication detection works by scanning the codebase to identify repeated code blocks. Once found, it suggests extraction opportunities to consolidate the repeated logic into shared, maintainable components.

Can I detect type safety issues like any types in my codebase?

Yes, you can detect type safety issues like `any` types and missing annotations. The analysis scans the codebase to flag these inconsistencies and provides recommendations to enforce stricter type safety.

When should I run a technical debt scan on my project?

You should run a technical debt scan after a development sprint. This timing allows you to get a report on areas needing refactoring, ensuring the codebase remains clean and efficient before starting new work.

Does this technical debt scanner identify performance anti-patterns?

Yes, the scanner identifies performance anti-patterns alongside dead code and duplication. It analyzes the codebase structure to detect these inefficiencies and suggests refactoring opportunities based on established patterns and project context.