How does the skill identify 'dead code'?

It scans for legacy markers, unused exports, and stale code patterns using language-specific AST parsers and file-level heuristics to ensure accuracy.

Can I use this for automated reporting?

Yes, the skill provides a JSON output format with severity levels (critical, warning, info), making it ideal for programmatic integration and automated health reporting.

What is the benefit of AST-based analysis?

AST (Abstract Syntax Tree) analysis allows the skill to understand the actual structure of your code at a function and method level, providing much more accurate data than simple regex-based scanning.

Does it require any external tools?

Python 3 is required. For optimal results, tools like ripgrep (rg), fd, git, node, and the Go toolchain are recommended but not mandatory for basic operation.

Which programming languages are supported?

The skill currently provides specific AST-based analysis for Go, Python, and JavaScript/TypeScript, while general health checks apply across the repository.

Code Health & Technical Debt Analyzer

Name: Code Health & Technical Debt Analyzer
Author: lepinkainen

bylepinkainen

0•

Security & Testing

Audits codebase quality by identifying technical debt, test coverage gaps, code duplication, and documentation issues across multiple programming languages.

The Code Health skill empowers Claude to perform deep-dive audits of software repositories to improve maintainability and performance. By leveraging AST-based analysis for Python, Go, and JavaScript/TypeScript, it identifies large files, calculates function-level complexity, detects dead or legacy code, and highlights areas lacking sufficient test coverage or documentation. This skill is essential for developers looking to prioritize refactoring efforts, onboard onto new projects, or maintain high-quality standards in evolving codebases by providing structured, actionable insights with clear severity levels.

Key Features

01Structured JSON output with severity levels (critical, warning, info) for programmatic remediation.

02Identification of test coverage gaps and missing test suites.

03Multi-language support for Python, Go, and JavaScript/TypeScript projects.

04Deep AST analysis for accurate function-level insights and duplicate detection.

05Automated detection of large files, high function counts, and git churn.

060 GitHub stars

Use Cases

01Performing a comprehensive codebase audit to identify and prioritize refactoring targets.

02Checking for undocumented exports and missing READMEs during a documentation sprint.

03Analyzing technical debt and dead code before a major system migration or version upgrade.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lepinkainen/skills code-health

For use in Claude.ai and ChatGPT

Download Skill