Tech Debt Analyzer

This one runs Python scripts to scan your JavaScript/TypeScript codebase for technical debt, then helps you document everything in a structured register. It catches the usual suspects: bloated files over 500 lines, functions with high complexity, deprecated dependencies, TODO comments, and TypeScript any types. The manual review checklist covers architectural problems, test gaps, and security issues that automation misses. What I like is the debt register template that forces you to justify priority and estimate effort, not just list problems. The 20% sprint capacity recommendation for debt work is solid advice, though good luck getting that past your PM. Best used when you inherit a messy codebase or need to make a case for refactoring time.

skills.sh installs: 988
GitHub stars: 467
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add ailabs-393/ai-labs-claude-skills --skill tech-debt-analyzer --agent claude-code

Installs into .claude/skills of the current project.

Files

Technical Debt Analyzer

Overview

Systematically identify, analyze, document, and track technical debt in JavaScript/TypeScript codebases. This skill provides automated analysis tools, comprehensive debt categorization frameworks, and documentation templates to maintain a technical debt register.

Core Workflow

1. Automated Analysis

Run automated scripts to detect technical debt indicators across the codebase.

Code Smell Detection

Identify code quality issues using the automated detector:

python3 scripts/detect_code_smells.py src --output markdown

The script analyzes:

Large Files: Files exceeding 500 lines
Complex Functions: High cyclomatic complexity (>10) or long functions (>50 lines)
Debt Markers: TODO, FIXME, HACK, XXX, BUG comments
Console Statements: Debug statements left in code
Weak Typing: Use of any type in TypeScript
Long Parameters: Functions with >5 parameters
Deep Nesting: Code nested >4 levels deep
Magic Numbers: Hardcoded numeric values

Output Example:

# Technical Debt Analysis Report

**Files Analyzed:** 127
**Total Lines:** 15,432
**Total Issues:** 89

SKILL.md on GitHub

Details

Repository: github.com/ailabs-393/ai-labs-claude-skills
Categories: Security, Documentation, Code Review & Quality, AI & Agent Building
First seen: May 16, 2026