Can I use this for automated reporting?

Yes, by using the --json flag, the tool outputs structured data that is perfect for integration into automated reports or for Claude to parse and act upon.

Does it require any external dependencies?

Python 3 is required. For the most accurate results, having tools like ripgrep (rg), fd, and the respective language runtimes (Node/Go) installed is highly recommended.

What specifically does the 'size' check analyze?

The size check monitors for exceptionally large files, high function counts, and git churn to identify code hotspots that are likely difficult to maintain.

Which programming languages does this skill support?

The skill features specialized AST-based support for Python, Go, and JavaScript/TypeScript projects, but can perform general directory-level health checks on most codebases.

How does the skill handle different severity levels?

Findings are categorized into 'critical' (needs immediate attention), 'warning' (should address soon), and 'info' (nice to fix) categories with suggested actions for each.

Code Health Auditor

Name: Code Health Auditor
Author: lepinkainen

bylepinkainen

0•

Security & Testing

Analyzes codebases to identify technical debt, test coverage gaps, and refactoring opportunities across multiple languages.

The Code Health Auditor skill provides a comprehensive suite of tools for auditing the quality and maintainability of a software project. By utilizing AST-based parsing and language-specific checks for Python, Go, and JavaScript/TypeScript, it automatically detects architectural issues such as overly large files, duplicate logic, dead code, and undocumented exports. It is particularly useful for developers performing code reviews, planning refactoring sprints, or onboarding onto legacy codebases where understanding technical debt and code churn is critical for progress.

Key Features

01Multi-language support for Python, Go, and JS/TS with auto-detection.

02Structured JSON output optimized for LLM consumption and programmatic workflows.

030 GitHub stars

04Automated identification of dead code, legacy markers, and stale exports.

05Test coverage gap analysis to find missing test files and quality issues.

06AST-based function analysis for high-precision code scanning and signature detection.

Use Cases

01Auditing public API surfaces for missing documentation and visibility issues.

02Identifying high-priority refactoring targets and large-file bottlenecks in legacy code.

03Scanning for duplicate function patterns and similar logic to consolidate code.

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