skills.rest
lepinkainen
lepinkainenCOMMUNITY
Explore all skills by this author →
GitHub

code-health

Analyze Go, Python, and JavaScript/TypeScript codebases for health issues and output JSON reports.

1|Updated Dec 17, 2025
Search Tags:#documentation#code-quality#duplication#static-analysis#test-coverage#dead-code#code-health
One-click install
npx skills add https://github.com/lepinkainen/skills --skill code-health-lepinkainen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-health
Source: https://github.com/lepinkainen/skills/tree/main/code-health
Command: npx skills add https://github.com/lepinkainen/skills --skill code-health-lepinkainen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Analyze codebases to surface health issues such as large files, test gaps, duplicates, dead code, and documentation problems. This helps teams quickly identify refactoring targets and reduce technical debt.

Core Features & Use Cases

  • Large-file detection and file-churn metrics across Go, Python, and JavaScript/TypeScript repos.
  • Test coverage gaps discovery and basic test-presence checks with guidance for adding tests.
  • Duplicate/legacy code hints and dead code markers to guide cleanup.
  • Documentation gaps discovery, including missing READMEs and undocumented exports.
  • Use Case: Run the health skill on a project to generate a prioritized list of cleanup targets for an upcoming sprint.

Quick Start

Run the health.py script against your project directory to generate a health report.

Frequently Asked Questions about code-health

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

FAQPage Schema
How do I audit code health to identify technical debt in my project?▼

Auditing code health involves analyzing your codebase to surface large files, test gaps, duplicates, dead code, and documentation problems to identify refactoring targets and reduce technical debt.

Best way to find dead code and duplicate code hints during refactor planning?▼

Finding dead code and duplicate hints during refactor planning is achieved by running static analysis on your repository to generate a prioritized list of cleanup targets and output structured JSON or a human-readable report.

How can I detect test coverage gaps and missing tests in a Python codebase?▼

Detect test coverage gaps in a Python codebase by scanning files to perform basic test-presence checks, discover missing tests, and output guidance for adding tests.

Does this static analysis tool support JavaScript, TypeScript, and Go repositories?▼

Yes, this static analysis tool supports JavaScript, TypeScript, and Go repositories, applying file scanning and line counting metrics to identify health issues across these specific languages.

How do I discover documentation gaps like missing READMEs and undocumented exports?▼

Discover documentation gaps like missing READMEs and undocumented exports by running a health script against your project directory to automatically scan and report missing documentation.

What are the limitations of running a code health audit on large files?▼

Limitations of running a code health audit include primarily detecting large files, test gaps, duplicates, dead code, and documentation problems across Go, Python, and JavaScript/TypeScript projects without deeper semantic data flow analysis.

Related Skills

Explore More Software Engineering Skills→
Cor-IncorporatedCor-Incorporated
4

code-reviewer

Automate code review workflows with Python scripts for static analysis and security checks.

Official
Advanced
sumilee-pcusumilee-pcu

tech-debt

Scan source code for TODOs and complexity hotspots to manage technical debt.

Community
Intermediate
gkganesh12gkganesh12
1

gk-review

Audit source code against documentation and test suites for architectural drift.

Community
Advanced
cegit27cegit27
3

health

Orchestrate code quality tools into a composite 0-10 score with trend tracking.

Official
Advanced