Tech Debt Analyzer
This tool automatically identifies potential technical debt in your codebase, helping developers prioritize fixes and improve code quality.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add tech-debt-analyzer npx -- -y @trustedskills/tech-debt-analyzer
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"tech-debt-analyzer": {
"command": "npx",
"args": [
"-y",
"@trustedskills/tech-debt-analyzer"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
The Tech Debt Analyzer skill helps developers systematically identify, analyze, document, and track technical debt within JavaScript/TypeScript codebases. It provides automated analysis tools to detect potential issues like large files, complex functions, deprecated dependencies, and more. The tool generates reports categorizing these debts by severity, enabling teams to prioritize remediation efforts and improve overall code quality.
When to use it
- When onboarding new developers to a project to quickly identify areas of technical debt.
- During regular code reviews to proactively surface potential issues.
- Before undertaking major refactoring or feature development to understand the existing codebase's health.
- To track and manage technical debt over time, ensuring consistent improvement.
- When identifying vulnerable packages in a project.
Key capabilities
- Automated Code Smell Detection: Identifies issues like large files (over 500 lines), complex functions (cyclomatic complexity >10 or length >50 lines), and problematic code comments (TODO, FIXME, etc.).
- Dependency Analysis: Detects deprecated packages, duplicate functionality, versioning problems, and potential security vulnerabilities in project dependencies.
- Categorization of Technical Debt: Classifies identified issues by severity (HIGH, MEDIUM, LOW).
- Report Generation: Creates markdown reports summarizing analysis findings.
- Framework for Manual Review: Provides guidance on areas to focus on during manual code reviews, including architectural, test, documentation and performance debt.
Example prompts
- "Analyze the codebase for technical debt indicators."
- "Run a dependency analysis report for package.json."
- "Detect code smells in the 'src' directory and output a markdown report."
Tips & gotchas
- The automated analysis relies on scripts executed via the command line (e.g.,
python3 scripts/detect_code_smells.py). Ensure Python 3 is installed and the necessary dependencies are available. - The tool focuses specifically on JavaScript/TypeScript codebases.
- Security concerns identified during dependency analysis require external audit data to be fully accurate.
Tags
TrustedSkills Verification
Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.
Security Audits
| Gen Agent Trust Hub | Pass |
| Socket | Pass |
| Snyk | Pass |
🌐 Community
Passed automated security scans.