analyze-tech-debt

Detect and prioritize technical debt in TypeScript codebases.

Updated Dec 11, 2025
One-click install
npx skills add https://github.com/semicolon-devteam/semo --skill analyze-tech-debt
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: analyze-tech-debt
Source: https://github.com/semicolon-devteam/semo/tree/main/packages/ops/improve/skills/analyze-tech-debt
Command: npx skills add https://github.com/semicolon-devteam/semo --skill analyze-tech-debt

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) components.

What problem does it solve?

์ฝ”๋“œ๋ฒ ์ด์Šค์˜ ๊ธฐ์ˆ  ๋ถ€์ฑ„๋ฅผ ์‹๋ณ„ํ•˜๊ณ , ๋ณด์•ˆ/์„ฑ๋Šฅ/๋ณต์žก๋„/์ค‘๋ณต ๋“ฑ ์นดํ…Œ๊ณ ๋ฆฌ๋ณ„๋กœ ์ •๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

Core Features & Use Cases

  • ๋ณด์•ˆ ์ทจ์•ฝ์ , ์„ฑ๋Šฅ ์ด์Šˆ, ์ฝ”๋“œ ๋ณต์žก๋„, ์ค‘๋ณต, ํ…Œ์ŠคํŠธ ์ปค๋ฒ„๋ฆฌ์ง€ ๊ฒ€ํ† 
  • ์šฐ์„ ์ˆœ์œ„๋ณ„ ์ˆ˜์ • ๊ณ„ํš ์ œ์‹œ

Quick Start

์ฝ”๋“œ๋ฒ ์ด์Šค๋ฅผ ์Šค์บ”ํ•ด ๋ถ€์ฑ„ ๋ชฉ๋ก๊ณผ ์‹œ๊ธ‰๋„๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

Frequently Asked Questions about analyze-tech-debt

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

FAQPage Schema
How do I identify technical debt in my TypeScript codebase?โ–ผ

Technical debt identification scans your TypeScript/TSX source files to detect security vulnerabilities like hardcoded secrets, performance issues such as N+1 queries and infinite re-renders, code complexity, duplication, and test coverage gaps. The process produces a markdown report categorized by severity with per-file details and prioritized remediation actions.

What types of issues does technical debt analysis detect?โ–ผ

The analysis detects five core issue categories: security vulnerabilities (hardcoded secrets), performance problems (N+1 queries, infinite re-renders), code complexity violations, duplicate code patterns, and test coverage gaps. Each finding includes file location, line number, impact assessment, and recommended priority for fixing.

Can I use technical debt analysis across my entire src directory?โ–ผ

Yes, the analysis applies across your entire src directory for TypeScript and TSX files. It scans all sources in scope, aggregates findings by severity and category, and generates a unified prioritized report with actionable recommendations for systematic remediation.

How should I prioritize which technical debt to fix first?โ–ผ

The analysis produces severity-based categories and a summarized priority ranking with recommended actions. Security vulnerabilities and performance issues typically receive highest priority, followed by code complexity and coverage gaps, allowing you to plan fixes systematically rather than arbitrarily.

What output format does the technical debt report use?โ–ผ

The analysis generates a markdown-formatted report organized by severity levels, with per-file details listing the file path, line number, specific issue, and impact. This structure enables easy review, sharing, and integration into your refactoring workflow and documentation.